Agent skill · mitscherlich
devloop
当用户要用 devloop 启动交付、继续已有 .devloop/<id>、初始化或维护项目知识库、收尾归档、从上一轮选择新 intent 时使用。支持 intent 确认、spec/plan 联审、独立实现与验收,以及发布交接。
What it needs
About 2k tokens when loaded.
What this skill does
devloop:从意图到可验证交付,再把知识带入下一轮 默认两次人工确认:简短 intent → spec/plan 联审并授权执行。实现由独立 runner 完成,跨工具 reviewer 验收;需求定稿后维护 docs/knowledge/specs/,收尾将规格、领域知识、经验与 ADR 分别归位,再提出有证据的下一轮候选。默认只做本地 commit。 先识别入口 所有入口必做:找到实际项目/执行 worktree,按 知识维护协议 运行 setup --check;缺入口则执行 setup,然后按索引读取本轮相关知识。用户限定只读时只报告缺口。每次会话进入或切换 worktree 检查一次,巡检不重复扫描;目录存在不代表内容已查证。 用户意图 动作与完成条件 --- --- 初始化 / 维护知识库 按知识维护协议建立入口、查证本次相关资料、更新知识及索引;不创建交付任务 新开 devloop 读项目规范和已有知识 → 初始化 → 澄清 intent → 设计联审;进入执行前须有真实授权 继续已有流程 找到实际执行 worktree,运行 next --dir;保留原确认、切片和验收边界 收尾 / 归档 直接读 收尾协议,检查当前切片和证据;无需重新 grill 需求 settle / 规格归档 按知识维护协议把已确认需求合并到 docs/knowledge/specs/<capability>/spec.md,同步领域/决策引用;保留本轮签署原件 从上一轮继续迭代 读取上一轮 closeout 的候选和相关项目知识;仅将已选候选变成新 ID 的 intent,补问新增不确定性 用户可直接说: 用 devloop 做 <需求>,先给 intent 草稿,只问阻塞问题,spec/plan 联审。 收尾 .devloop/<id>:核对验收,提炼项目知识,将 spec/领域/经验/ADR 归位,并给下一轮候选。 从上一轮 closeout 的候选 N1 新开 devloop;沿用仍有效的决定。 CLI 入口 next 只读,返回 stage/action 和失败项。awaitreview 表示等待已有材料的审阅,不要继续制造问题。CLI 详细契约见 control-plane。CLI 沿用 POSIX shell 和标准工具;规格语义合并按知识维护协议执行。 1. Intent:先写草稿,只问当前阻塞 1. 结合入口已读取的项目知识和需求材料查代码确认事实;已有裁决检查是否仍适用,直接引用。 2. init 先落盘。新 intent 默认 reviewmode: joint,初始化维护 .devloop/.gitignore,只忽略任务下的过程文档和 run/;持久 specs 与该忽略文件可提交。已有跟踪不会被自动取消;暂存始终使用明确路径。 3. 写一屏可读的核心:问题与受影响者、期望结果、本轮范围、硬约束与非目标。先确认范围,再深入范围内的取舍。架构红线可进 intent;实现文件、CSS/依赖配置等放 spec/plan。 4. 维护 design tree / frontier,但只询问会阻止理解业务目标、划定范围或遵守硬边界的问题。一次一题,题干包含「已定什么、这次决定什么、影响什么、推荐与取舍」。用平台适用的提问通道;授权依平台规则取得,不能把沉默当确认。 5. 每题后更新当前生效的正文和 I 编号。替代旧决定时保留稳定 ID,记录替代原因和用户来源到 progress,同步所有受影响段落。每 3 个实质裁决或会话恢复时,用不超过 5 行回顾已定范围、变化及剩余阻塞项。 6. 事实由 Agent 查证,可逆技术选择由 Agent 提出方案;后续阶段问题按 管线契约 的 stage/owner/due 格式转交。无需把所有未知都在 intent 清零。 7. 当业务目标和硬边界已明确、本阶段无阻塞、后续问题有归属和期限时,运行 intent 草稿检查;给用户审阅当前 intent。取得实际确认后记录来源、审阅人与结论,运行正式门禁 A。 提问超过约 5 个关键决策仍无法收敛时,先总结导致发散的依赖,收窄这一轮可交付范围或安排查证;这是诊断提醒,不是省略必要裁决的硬限额。用户已要求完整范围时,保留范围并说明剩余阻塞。 若用户已有成熟规格,允许从 spec 开始,但先将既有目标、红线和授权来源整理成简短 intent,经用户确认或引用已有明确确认;不要重新访谈已定问题。 2. Spec + Plan:草稿联审,正式门禁仍分开检查 按 pipeline.md 编译与签署,模板在 templates/。 1. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills mitscherlich/devloop