docs: remove deleted project docs skill requirement
This commit is contained in:
1 parent
515b545b32
commit
bb115a3382
13 files changed
+114
-59
No files matched your search
@@ -1,21 +1,23 @@
|
||||
# LTJT 项目文件治理规则
|
||||
|
||||
本文件约束所有后续维护会话。用户指令优先;在没有新的明确指令时,必须遵守以下位置、所有权、同步和归档规则。
|
||||
本文件约束所有后续维护会话。用户指令优先;在没有新的明确指令时,必须遵守以下位置、协作、同步和归档规则。
|
||||
|
||||
## 开始工作前
|
||||
|
||||
1. 运行 `git status --short`,保留所有既有未提交改动;禁止 `git reset --hard`、`git clean` 或批量回退。
|
||||
2. 加载 `maintain-project-docs` Skill,先运行其 Concurrent Task Gate。任何代码或项目文档编辑前,`task_context.py start` 必须成功,且 `status --json` 中的 task ID、mode、绝对 worktree、branch 与当前任务完全一致。
|
||||
3. 所有权门禁通过后,按 `.project-docs/05-agent-entry/read-before-planning.md` 的顺序加载当前任务和 canonical 项目记忆;Feature 与 Integration 写入边界以该 Skill 和 `.project-docs/90-maintenance/doc-update-policy.md` 为准。
|
||||
2. 运行 `git branch --show-current`、`git rev-parse --show-toplevel` 和 `git worktree list --porcelain`,按 `.project-docs/05-agent-entry/concurrent-task-gate.md` 完成仓库内自包含的 worktree 安全检查。
|
||||
3. 按 `.project-docs/05-agent-entry/read-before-planning.md` 的顺序加载当前任务和 canonical 项目记忆;Feature 与 Integration 写入边界以 `.project-docs/90-maintenance/doc-update-policy.md` 为准。
|
||||
4. 通过 `agent设计规范/business-adaptation-registry.md` 定位业务,再读取对应业务页、Skill、Schema、mapping 和实现代码。
|
||||
5. `archive/` 只供追溯,不能反向覆盖当前业务规则;若历史文件与活动源码冲突,以活动源码及当前契约为准。
|
||||
|
||||
仓库不依赖外部项目文档 Skill。已删除的 `maintain-project-docs`、`task_context.py` 或其专属检查脚本不得作为开始、编辑、验证或完成任务的前置条件。
|
||||
|
||||
## 并发与子智能体
|
||||
|
||||
- 原则上不创建子智能体;确有必要时必须先取得用户明确同意。
|
||||
- 一个活动任务只拥有一个 worktree;不得在已被其他任务占用或归属不明的 dirty worktree 中继续。
|
||||
- 不得用 Markdown 或口头约定模拟任务所有权;只能使用 `maintain-project-docs` 自带的 `task_context.py`。
|
||||
- 未知改动不得自动 stash、reset、移动、删除或认领;采用 `--adopt-existing` 必须有用户对已知改动的明确接管授权。
|
||||
- 一个 worktree 同一时间只承载一个活动任务的编辑;不得在已被其他任务占用或归属不明的 dirty worktree 中继续。
|
||||
- `.project-docs/` 的任务记录用于持久上下文和交接,不充当进程锁或外部所有权注册表;并发判断以当前 Git worktree、branch、status 和可见任务范围为准。
|
||||
- 未知改动不得自动 stash、reset、移动、删除或认领;若与当前目标重叠且无法安全绕开,必须先询问用户。
|
||||
|
||||
## 根目录边界
|
||||
|
||||
@@ -35,7 +37,7 @@
|
||||
|
||||
| 位置 | 唯一职责 | 禁止内容 |
|
||||
|---|---|---|
|
||||
| `.project-docs/` | 任务作用域记录、canonical 项目记忆、证据索引、反思、承诺和文档维护状态 | 运行日志、秘密、业务附件、绕过所有权门禁的共享进度 |
|
||||
| `.project-docs/` | 任务作用域记录、canonical 项目记忆、证据索引、反思、承诺和文档维护状态 | 运行日志、秘密、业务附件、把任务记录当作并发锁的共享进度 |
|
||||
| `agent设计规范/` | Agent Prompt、五个 Skill、业务模板、业务入口与稳定测试夹具的可编辑源 | 发布包、运行日志、历史版本副本 |
|
||||
| `schemas/` | 当前解析态、执行态和 ERP 表单 Schema | 历史 Schema、运行结果 |
|
||||
| `mappings/` | 当前 ERP 字段与生命周期 mapping | 探针输出、旧版本副本 |
|
||||
@@ -51,13 +53,13 @@
|
||||
| `quarantine/` | 无法安全解析的外部输入隔离边界 | 当前源码或已信任 fixture |
|
||||
| `archive/` | 日期化、只读、可恢复的历史实现、证据、规划和发布物 | 当前入口或需要运行时读取的文件 |
|
||||
|
||||
## Maintain Project Docs
|
||||
## 项目记忆维护
|
||||
|
||||
- `.project-docs/30-worklog/tasks/<task_id>.md` 是任务局部范围、约束、结果、验证、后续项和 Promotion Candidates 的唯一记录。
|
||||
- Feature 模式只写当前 task ID 所属记录和允许的 task-prefixed supporting records;不得更新 `current-state.md`、共享索引、accepted ADR、canonical 架构、业务规则或共享聚合。
|
||||
- Integration 模式必须独占 worktree 和集成锁,才能把已接受事实写入 canonical 项目记忆;冲突的产品行为、架构方向或真相源必须由用户决定。
|
||||
- Integration 模式必须使用无冲突的独立 worktree,或在用户明确要求直接更新当前分支时确认既有改动均已知且不重叠,才能把已接受事实写入 canonical 项目记忆;冲突的产品行为、架构方向或真相源必须由用户决定。
|
||||
- `current-state.md` 是上次集成快照,不代表其他并行任务的实时状态;其他任务只通过其 task record 做只读范围评估。
|
||||
- 仓库变更任务完成前必须更新任务记录、运行 `check_doc_drift.py --task-id <task_id>`,再用 `task_context.py complete` 标记 `ready_for_integration`。
|
||||
- 仓库变更任务完成前必须更新当前任务记录并执行本仓库已有、与改动相关的验证;不要求外部完成命令或状态注册。
|
||||
- 历史 Planning with Files 只供追溯;不得从归档复制回活动项目记忆。
|
||||
|
||||
## 单一源与同步矩阵
|
||||
@@ -79,14 +81,7 @@
|
||||
|
||||
## 验证
|
||||
|
||||
项目文档或仓库文件调整后,先按已加载的 `maintain-project-docs` Skill 运行:
|
||||
|
||||
```text
|
||||
scripts/check_project_docs.py
|
||||
scripts/check_doc_drift.py --task-id <task_id>
|
||||
```
|
||||
|
||||
再至少运行:
|
||||
项目文档或仓库文件调整后,至少运行仓库内已有的以下检查:
|
||||
|
||||
```bash
|
||||
node --run check:repo
|
||||
|
||||
Reference in new issue
Block a user