From e126bd4f00fcb3c2659d54b0474882a7b6a6da24 Mon Sep 17 00:00:00 2001 From: mujing Date: Fri, 11 Sep 2026 09:59:58 +0800 Subject: [PATCH] feat: derive tests from goals and format Markdown assets --- README.md | 4 ++++ skills/align-plan/SKILL.md | 4 +++- skills/execute-plan/SKILL.md | 4 +++- 3 files changed, 10 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index e46a68c..1d4511a 100644 --- a/README.md +++ b/README.md @@ -56,6 +56,8 @@ Codex 默认根据 `description` 隐式选择 skill；本仓库在每个 skill 计划预先评估兼容性，执行结果根据实际改动复核接口、数据、配置及新旧版本影响。结果明确是否需要特殊上线步骤和顺序；需要时提供前置条件、顺序、验证点及必要回退限制，无需时明确说明，未知项如实标注。上线评估不等于实际部署授权。 +测试从原始目标推导正常、边界、异常及保留行为场景，预期结果独立于实现，确保能发现目标偏离；不为覆盖变更代码而堆用例。 + ## 资产约定 首次未指定资产目录时会询问；之后从项目 `.agent/MEMORY.md` 复用。这个文件只保存必要定位信息，通过 Git 本地 exclude 排除，不修改项目共享 `.gitignore`。已被跟踪时会先报告冲突，不自行取消跟踪。 @@ -93,6 +95,8 @@ Codex 默认根据 `description` 隐式选择 skill；本仓库在每个 skill CONTEXT 的目标填写“保存系统当前业务与技术约束”，时间为最近一次确认系统决策的日期；普通排版更新不修改该日期。 +Markdown 正文使用带语言标记的代码块包裹代码、命令和多行配置，行内代码标记路径与标识符，`>` 标记原文引用并注明来源；顶部 YAML 不套代码块。不为排版增加冗余内容。 + ## 验证 结构检查： diff --git a/skills/align-plan/SKILL.md b/skills/align-plan/SKILL.md index 47f12a3..b30b2c6 100644 --- a/skills/align-plan/SKILL.md +++ b/skills/align-plan/SKILL.md @@ -26,6 +26,8 @@ description: 仅在用户明确要求使用 align-plan 时启用。通过调查 时间使用用户当地决策日期；草稿先记创建日期、确认后更新，进度与排版不改日期。 +Markdown 正文按内容排版：代码、命令及多行配置用带语言标记的围栏代码块，标识符与路径用行内代码，原文引用用 `>` 并注明来源。顶部 YAML 直接保留，不把全文包进代码块；排版不增加原本不需要的内容。 + ## 系统约束与讨论状态 先读根目录 `CONTEXT.md`，再调查相关代码；不扫描历史计划。首次无 CONTEXT 时，从首条已确认长期约束开始创建。 @@ -51,7 +53,7 @@ description: 仅在用户明确要求使用 align-plan 时启用。通过调查 1. **定位**：项目及必要仓库标识、资产根目录与 CONTEXT 绝对路径、Git 基线（无提交则注明）、相关工作区变化、确认状态/依据。 2. **目标与决策**：原始目标、当前/目标行为、保留行为、不做事项；决策理由、业务/接口/架构变化或不变；相关系统约束快照及状态、已确认假设。 3. **修改范围**：新增/修改/删除的文件、各自目标和原因、必要依赖顺序及对应验收。允许必要测试/配置配套文件并记录，其他范围变化重新确认。 -4. **验证**：验收条件、对应测试、运行目录/命令/预期结果与必要环境。 +4. **验证**：从原始目标推导正常、边界、异常及保留行为场景，明确预期结果和对应验收；列测试、运行目录/命令与必要环境。不能仅按变更代码列用例，预期行为须独立于实现，能发现偏离目标的结果。 5. **兼容与上线**：评估受影响的接口、数据、配置及新旧版本兼容性；明确是否需要迁移、特殊上线步骤或先后顺序，必要时说明回退限制。无特殊要求则注明，未知项列为待核实。 不预写详细实现代码；仅核心算法可附少量审查片段，执行 agent 可自主选择满足已批准约束的实现。 diff --git a/skills/execute-plan/SKILL.md b/skills/execute-plan/SKILL.md index 9e767c1..1ce4602 100644 --- a/skills/execute-plan/SKILL.md +++ b/skills/execute-plan/SKILL.md @@ -31,6 +31,8 @@ description: 仅在用户明确要求使用 execute-plan 时启用。执行已 执行记录沿用计划决策日期，执行时间另记正文；计划重新批准后用用户当地确认日期。进度与排版不改日期；旧元数据缺失不等于缺少批准，不编造日期。 +Markdown 正文中代码、命令和多行配置用带语言标记的围栏代码块，标识符与路径用行内代码，原文引用用 `>` 并注明来源。顶部 YAML 不包代码块，不为排版添加冗余内容。 + - CONTEXT 只记录已确认且当前有效的业务约束、技术约束，可注明适用模块及必要原因；不放待实施方案、废弃决策、历史计划路径、任务、代码或日志。目标为“保存系统当前业务与技术约束”，时间为最近确认决策日期。局部编码选择不提升为系统约束。 - 对照 CONTEXT 与计划：无关更新继续，其他实质冲突先澄清。实施、验证及 review 完成后，重读 CONTEXT，用本次落实的约束替换失效规则，保留无关的有效约束；失败或部分完成不提前更新，不记录状态变迁或旧规则。 - 执行记录仅保留任务状态、配套文件及理由、关键验证命令/结果、兼容性与上线要求、阻塞与偏差，不粘贴完整工具日志。恢复会话或压缩后重读 CONTEXT、计划和执行状态；无变化时复用已读内容。 @@ -48,7 +50,7 @@ description: 仅在用户明确要求使用 execute-plan 时启用。执行已 ## 验证、Review 与提交 1. 完成后重新完整读取原目标与批准计划，对照任务 diff：验收是否满足、保留行为是否成立、是否越界、是否影响调用方与错误路径。 -2. 运行计划要求及改动必要的检查，覆盖验收与回归风险。复用已有测试，补真实缺口，不堆重复用例或强制覆盖率；文档变更用适当结构检查。记录实际证据，无变化且无新疑点时不重复运行。 +2. 先从原始目标和验收推导正常、边界、异常及保留行为测试，断言依据需求而非复制实现逻辑；核对用例能否发现目标偏离，不只验证修改的代码是否按自身逻辑运行。复用已有测试、补真实缺口，不堆重复用例或追求覆盖率数字。运行计划要求及必要回归检查，文档变更用适当结构检查；记录实际证据，无变化且无新疑点时不重复运行。 3. Review 范围、正确性、模块职责/依赖边界及失效代码清理，修复本任务问题后重跑受影响检查。越界内容仅撤销能可靠隔离的自身改动。未解决失败或环境阻碍如实报告，不宣称通过、不绕过检查提交；用户调整验证要求时记录差异。 根据实际 diff 与证据复核接口、数据、配置及新旧版本兼容性。需要特殊上线操作时列出前置条件、步骤顺序、验证点及必要回退限制；否则明确“无需特殊上线步骤或顺序”。未知或未验证部分如实标注，不把本地测试通过等同于上线兼容。涉及计划外迁移或行为变化时先更新计划并确认；评估不授权实际部署。 4. 仅暂存本任务文件/片段，检查完整暂存 diff，确保不含用户原有改动、MEMORY 或讨论资产。无法隔离或 MEMORY 已被跟踪时先解决，不擅自取消跟踪。