用途:woostack-init 帮助用户创建或改进仓库根目录的 README 与项目指导文档,使其准确、贴合仓库、便于决策、简洁且可维护。命令为 /woostack-init [path],默认意图是引导式文档编写,也支持仅限单个文档、评审、规划或草稿的请求。
主要能力:先检查证据再提问,读取相关对话决策、现有根级与作用域代理指令、README/贡献指南、产品与设计文档及其权威来源、代表性代码、脚本和 CI,区分已观察实现、已记录意图与未决决策,并保留现有有效内容。仅在答案会改变读者首次使用路径、产品行为、设计方向或工作约定时,才提出基于仓库的问题。按文档职责起草:README.md 说明项目是什么及如何开始;PRODUCT.md 记录用户、目的、能力与约束;DESIGN.md 描述产品如何运作与呈现;AGENTS.md 提供可操作命令、工作目录、边界与陷阱。
使用方式:文档工作不需要 .woostack/、GitHub 策略校验、Doctor 或 GitHub 访问。本地支持路径仅用于显式的支持初始化/修复,保持本地且不依赖提供方,使用 scripts/config/resolve-config.sh 解析有效本地策略,合并 .woostack/config.json 与可选的 .woostack/config.local.json,仅创建缺失的支持路径,如从 templates/config.json 生成 .woostack/config.json。
限制:不编写应用源码或脚手架,不创建 issue、Project、分支、提交、PR 或生命周期状态,不推送、合并、读写凭据、迁移保留数据或执行破坏性清理。不编造命令、指标、架构理由或已定决策。仅评审、仅草稿或规划请求不写入任何内容。未授权范围扩展仅作为提案。不推断 GitHub 所有者、Project、Status 字段、issue 或发布目标,不联系提供方,不选择远程持久化。现有 .woostack/tmp/runs/、旧草稿、清单、锁、报告和远程记录属于历史用户数据,不导入、重写、删除或重建。缺失技能不得阻塞普通仓库工作。