SuperAPI AI 工具集

adopt

设计与创作

查看项目

更新于 10-15 21:03

技能介绍

用途:Adopt 用于把既有(brownfield)项目的知识所有权迁移进 .devflow/,不要求用户重述可从维护来源确认的事实,也不把旧文档当作永久参考。仅在用户明确要求接管既有项目,或其他 Devflow 路线发现缺少内部基础的维护材料时进入。

主要能力:建立 .devflow/adoption/ 工作区,含 state.md、sources.md、conflicts.md;用 include/exclude 边界对维护来源分组并记账,记录来源性质与权威、目标归属、处置状态与未覆盖路径数;按来源权威读取代码、测试、配置与意图文档,把知识单元区分为 observed fact、interpretation、unknown 与 conflict;重构并发布 .devflow/project/product.md、domains/<domain>/index.md、architecture.md,仅在架构表明适用且来源确有规则时发布 design.md;将无法解决的矛盾写入 conflicts.md 并路由到 product、architecture 或 design 决策。

使用方式:执行前先读 references/communication.md,进入 gate 时读 references/project-gate.md 与 project-knowledge.md;写文档前分别读 product-document.md、architecture-document.md、design-document.md、decision-document.md;需要保留本地上下文时读 team-context.md;提问前读 question-dialogue.md。写入前检查 Git 状态并识别仓库边界,保留无关的未提交改动。

适用场景:接管缺乏内部基础的既有项目;迁移旧 Devflow 格式;在已记账边界内开启纵向切片工作。

限制:不实现产品变更、不创建 Work 契约、不迁移 legacy Devflow 状态,也不声称路径覆盖等于语义完整;未记账的仓库整体不算就绪;冲突未解决前不关闭 adoption;旧文档只有在知识全部落地或成为显式冲突后才失去权威。具体命令与价格信息暂未提供。