User Input
$ARGUMENTS
Accepted: empty | --draft | confirm DOC-xxx [path] | upload(用户自备).
Outline
/pm-docs 只管文档索引与补齐。用户以中文交互时用中文回复。正式文档未经确认不得写入业务树。
- Require
.pm/。缺则建议/pm-init。 - 先读
.pm/architecture/map.json与现有.pm/state/doc-index.md(若有)。禁止为找文档做无过滤全库递归。 - 运行
pm docs(刷新索引 +.pm/state/doc-index.json)。列出缺失与possibly_stale。 - 双模式(对每条缺失):
- 自备 / upload:告诉用户把文件放到索引
expected路径,再跑一次pm docs。 - 起草:运行
pm docs --draft,只写.pm/docs/drafts/DOC-*.md。按地图 / README / 注释填草稿,保持可编辑。停下等确认。
- 自备 / upload:告诉用户把文件放到索引
confirm DOC-xxx [path]:仅在用户明确指定正式路径后,把草稿复制过去。默认建议.pm/docs/或用户点名的docs/*.md。未指定路径则继续只留在 drafts。- 过期文档:只提示代码变更可能新于文档,默认不自动改正文。
- Closing:
_closing.md轻量档。指向doc-index.md与已有草稿。
Done When
- 索引已更新(中文)
- 草稿未写入业务树,除非用户确认了路径
- 无秘密落盘
Shared Workflow
Map-first. Redact. Confirm-before-write for official docs. Design baseline: docs/prd.md + 宪章。