refactor: clarify skill completion and require verified local commits

2026-09-16 14:11:00 +08:00
parent e126bd4f00
commit f2443a4855
3 changed files with 15 additions and 11 deletions
@@ -1,11 +1,11 @@
 ---
 name: align-plan
-description: 仅在用户明确要求使用 align-plan 时启用。通过调查和多轮问答对齐工程目标，生成待审阅计划；不实施代码。
+description: 仅用户指定 align-plan 时启用；对齐工程目标与边界，生成待审阅计划，不实施代码。
 ---

 # 对齐目标并生成计划

-先调查、再决策；产出新会话仅凭计划和代码库即可执行的文件。
+完成条件：目标和关键决策已对齐，自包含的 plan.md 已保存并经用户确认，可交给新会话执行。具体调查方法与深度按任务选择，不要求完整仓库扫描。

 ## 定位与资产

@@ -34,11 +34,11 @@ Markdown 正文按内容排版：代码、命令及多行配置用带语言标

 - `CONTEXT.md`：只按业务约束、技术约束记录当前有效规则，可注明适用模块及必要原因。确认且无需实施的约束直接更新；尚未生效的改造只留在当前讨论和计划中。冲突先确认，替换时删除废弃内容，不保留决策过程、历史计划路径、任务、代码、日志或局部实现偏好。目标为“保存系统当前业务与技术约束”，时间为最近确认决策日期。
 - `<计划目录>/current.md`：每轮更新目标、验收、确认决策与原因、事实来源、约束、不做事项、未确认假设和问题；删除失效内容，不累计讨论历史。
- 新会话、压缩恢复或出现矛盾时重读 CONTEXT、当前状态和相关代码；其余时候复用无变化内容。确认状态以真实回答为准，沉默和推荐都不算批准。
+- 新会话或压缩恢复时读取 CONTEXT 与当前状态，按未决问题补读相关代码；出现矛盾时只复核相关资料，其余复用无变化内容。确认状态以真实回答为准，沉默和推荐都不算批准。

 ## 调查与提问

- 先查相关代码、调用链和测试。仅为当前决策查证开源实现或官方资料，保留来源和必要版本；无法查证的事实标为待验证。
+- 调查限于当前目标所需的代码、调用链和测试；只有涉及架构、数据或上线时才补读相应资料。外部查证须能解决具体未决问题，保留来源和必要版本，不为走流程搜索。
 - 每轮共 1–3 个影响目标、验收或取舍的问题，不能用子问题变相扩充。可查事实不问用户，依赖未决答案的问题后置；有提问工具则使用，否则直接问。
 - 简述证据与推荐理由，不用装饰性 emoji。纠正错误事实，区分假设与偏好；用户提出想法不等于确认方案。
 - 优先复用现有能力，选择满足目标的最小方案。出现独立子目标或明显扩大的改造时，说明扩大点、建议分阶段，由用户选择；未确认前保持原范围。