docs: 增加轻量项目治理模式 (#30)

This commit is contained in:
ila
2026-09-02 10:13:47 +08:00
parent cbdd27d861
commit fe795c4367
7 changed files with 102 additions and 98 deletions
+12 -9
View File
@@ -68,6 +68,7 @@ CORE_DOCUMENT_REQUIREMENTS = {
),
"docs/00-project-profile.md": (
"## 基本信息",
"## 项目治理模式",
"## DevHarness 来源与基线",
"## 子项目与交付单元",
"## 技术栈与运行环境",
@@ -78,11 +79,11 @@ CORE_DOCUMENT_REQUIREMENTS = {
"docs/01-workflow.md": (
"## Gitea 交互与工单最小读取",
"## 新项目 Wiki 初始化门禁",
"## 工单与设计证据双门禁",
"## 按治理模式选择最小门禁",
"### 不可裁剪底线",
"### 先判断是否需要工单",
"### 再判断设计证据",
"### 线上原型审核与按需导出",
"### 记录和重新确认",
"## 面向初级维护者的修改边界",
"## 每个任务的文档影响",
"## 需求记录与流转",
@@ -125,6 +126,7 @@ CORE_DOCUMENT_REQUIREMENTS = {
),
"docs/07-new-project-documentation-setup.md": (
"## 初始化顺序",
"#### 选择治理模式",
"#### 需求总览启用条件",
"### 2. 选择建设基线",
"#### 工程基线裁剪",
@@ -330,11 +332,11 @@ def check_agent_efficiency_rules(errors: list[str], root: Path = ROOT) -> None:
"#### 渐进执行和修复",
"#### 复用已验证事实",
"#### 明确停止条件",
"单元任务是唯一正式实施单位",
"需要工单时,单元任务是正式实施单位",
"高风险修改必须停止",
"用户没有明确验收通过前不得关闭",
"只有长期事实变化时才修改 Wiki",
"Gitea 工单是单次任务需求、变化、实现、测试、提交和验收的事实来源",
"需要工单的任务以 Gitea 工单作为需求、变化、实现、测试、提交和验收的事实来源",
"默认不创建任务归档",
"### Gitea 交互与工单最小读取",
"查询、创建、更新、评论、状态变更及关闭操作",
@@ -344,18 +346,19 @@ def check_agent_efficiency_rules(errors: list[str], root: Path = ROOT) -> None:
"### 新项目 Wiki 初始化门禁",
"`Home` 不存在时必须先创建 `Home`",
"不得把模板自带的本地 `docs/` 当作新项目 Wiki 已初始化的证据",
"提交只包含当前工单相关文件",
"提交只包含当前任务相关文件",
"不得仅为设置编码重复启动一层 PowerShell",
"文件解码和控制台输出分别处理",
"不得默认使用 `-ExecutionPolicy Bypass`",
"### 工单与设计证据双门禁",
"新页面、独立用户功能、重大交互或导航变化",
"### 按治理模式选择最小设计证据",
"轻量模式的小 Bug、局部样式或布局",
"明确为虚构的测试数据无需形式化脱敏",
"完整独立需求、新页面、重大交互或导航变化",
"`prototypes/<工单号>/<版本>/index.html`",
"默认直接通过 Quant-UX 或其他设计工具的线上链接审核",
"已确认的本地快照不得原位覆盖",
"`导出原型 #N`",
"`导出全部原型`",
"代码组件名、类名、变量、国际化键、API 字段和数据库字段不是显示文案",
"### 自然语言快捷指令",
"`只分析`",
"`建工单`",
@@ -391,7 +394,7 @@ def check_repository_readme(errors: list[str], root: Path = ROOT) -> None:
"`Home` 不存在时先创建并回读 `Home`",
"本地 `docs/` 的存在不能证明线上 Wiki 已初始化",
"python dev_scripts/harness.py sync --verify",
"Gitea 工单是单次任务唯一事实来源",
"需要工单的任务以 Gitea 工单为单次任务事实来源",
"默认不创建任务归档",
)
for section in missing_sections(content, required):