@givolt/i3-composer-agent 3.1.0 → 3.2.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.agents/plugins/marketplace.json +1 -1
- package/.claude/commands/i3-sop.md +3 -3
- package/.claude-plugin/marketplace.json +1 -1
- package/.claude-plugin/plugin.json +1 -1
- package/.codex-plugin/plugin.json +1 -1
- package/.gemini/commands/i3-sop.toml +3 -3
- package/README.md +22 -27
- package/commands/i3-sop.toml +3 -3
- package/docs/codex-setup.md +1 -1
- package/docs/other-hosts.md +1 -1
- package/docs/workbuddy-setup.md +1 -1
- package/evals/cases/i3-enterprise-sop.json +70 -32
- package/evals/zh-CN/cases/i3-enterprise-sop.json +77 -31
- package/package.json +1 -23
- package/plugin.json +1 -1
- package/skills/i3-enterprise-sop/SKILL.md +151 -91
- package/skills/i3-enterprise-sop/references/engineering-skeleton/directory-standard.md +29 -15
- package/skills/i3-enterprise-sop/references/handoff.py +171 -100
- package/skills/i3-enterprise-sop/references/read_text.py +60 -0
- package/skills/i3-enterprise-sop/references/technical-baseline/baselines/enterprise-application-technical-baseline-v0-0-4.md +28 -28
- package/skills/i3-enterprise-sop/references/technical-baseline/readme.md +9 -118
- package/skills/i3-enterprise-sop/references/{ad/templates → templates}/ad.md +34 -27
- package/skills/i3-enterprise-sop/references/{brd/templates → templates}/brd.md +21 -10
- package/skills/i3-enterprise-sop/references/{prd/templates → templates}/prd.md +57 -24
- package/skills/i3-enterprise-sop/references/{testcase/templates → templates}/testcase.md +32 -22
- package/docs/upstream-repository/AGENTS.md +0 -92
- package/docs/upstream-repository/CLAUDE.md +0 -60
- package/docs/upstream-repository/CONTRIBUTING.md +0 -137
- package/docs/upstream-repository/README.md +0 -8
- package/docs/upstream-repository/gitattributes.txt +0 -1
- package/docs/upstream-repository/gitignore.txt +0 -10
- package/docs/upstream-repository/manifest.json +0 -71
- package/docs/upstream-repository/opencode-skills.link +0 -1
- package/docs/upstream-repository/skill-gap.yml +0 -80
- package/docs/upstream-repository/skills-contributing.md +0 -15
- package/docs/upstream-repository/test-plugin-install.yml +0 -167
- package/skills/i3-enterprise-sop/references/ad/assets-manifest.json +0 -86
- package/skills/i3-enterprise-sop/references/ad/prompts/01-generate.md +0 -58
- package/skills/i3-enterprise-sop/references/ad/prompts/02-review.md +0 -54
- package/skills/i3-enterprise-sop/references/ad/prompts/03-revise.md +0 -54
- package/skills/i3-enterprise-sop/references/ad/prompts/04-recheck.md +0 -54
- package/skills/i3-enterprise-sop/references/ad/readme.md +0 -70
- package/skills/i3-enterprise-sop/references/assets-manifest.json +0 -230
- package/skills/i3-enterprise-sop/references/brd/assets-manifest.json +0 -83
- package/skills/i3-enterprise-sop/references/brd/prompts/01-generate.md +0 -51
- package/skills/i3-enterprise-sop/references/brd/prompts/02-review.md +0 -47
- package/skills/i3-enterprise-sop/references/brd/prompts/03-revise.md +0 -47
- package/skills/i3-enterprise-sop/references/brd/prompts/04-recheck.md +0 -47
- package/skills/i3-enterprise-sop/references/brd/readme.md +0 -50
- package/skills/i3-enterprise-sop/references/codebuddy-project-guide.md +0 -34
- package/skills/i3-enterprise-sop/references/controlled-handoff.md +0 -41
- package/skills/i3-enterprise-sop/references/controlled_handoff.py +0 -379
- package/skills/i3-enterprise-sop/references/engineering-skeleton/adoption.md +0 -200
- package/skills/i3-enterprise-sop/references/engineering-skeleton/catalog.json +0 -17
- package/skills/i3-enterprise-sop/references/engineering-skeleton/readme.md +0 -52
- package/skills/i3-enterprise-sop/references/handoff-contract.md +0 -196
- package/skills/i3-enterprise-sop/references/lifecycle-contract.md +0 -91
- package/skills/i3-enterprise-sop/references/plan-handoff.md +0 -73
- package/skills/i3-enterprise-sop/references/prd/assets-manifest.json +0 -109
- package/skills/i3-enterprise-sop/references/prd/prompts/01-generate.md +0 -64
- package/skills/i3-enterprise-sop/references/prd/prompts/02-review.md +0 -49
- package/skills/i3-enterprise-sop/references/prd/prompts/03-revise.md +0 -48
- package/skills/i3-enterprise-sop/references/prd/prompts/04-recheck.md +0 -47
- package/skills/i3-enterprise-sop/references/prd/readme.md +0 -137
- package/skills/i3-enterprise-sop/references/prd/template-contracts.md +0 -39
- package/skills/i3-enterprise-sop/references/prd/templates/ad.md +0 -17
- package/skills/i3-enterprise-sop/references/readme.md +0 -167
- package/skills/i3-enterprise-sop/references/recovery-contract.md +0 -65
- package/skills/i3-enterprise-sop/references/review-handoff.md +0 -105
- package/skills/i3-enterprise-sop/references/selection-handoff.md +0 -55
- package/skills/i3-enterprise-sop/references/selection_handoff.py +0 -225
- package/skills/i3-enterprise-sop/references/stages.json +0 -271
- package/skills/i3-enterprise-sop/references/technical-baseline/assets-manifest.json +0 -84
- package/skills/i3-enterprise-sop/references/template-contracts.md +0 -142
- package/skills/i3-enterprise-sop/references/testcase/assets-manifest.json +0 -91
- package/skills/i3-enterprise-sop/references/testcase/prompts/01-generate.md +0 -53
- package/skills/i3-enterprise-sop/references/testcase/prompts/02-review.md +0 -51
- package/skills/i3-enterprise-sop/references/testcase/prompts/03-revise.md +0 -49
- package/skills/i3-enterprise-sop/references/testcase/prompts/04-recheck.md +0 -51
- package/skills/i3-enterprise-sop/references/testcase/readme.md +0 -61
- package/skills/i3-enterprise-sop/references/verification/check_execution.py +0 -185
- package/skills/i3-enterprise-sop/references/verification/check_native_execution.py +0 -282
- package/skills/i3-enterprise-sop/references/verification/check_reads.py +0 -348
- package/skills/i3-enterprise-sop/references/verification/readme.md +0 -149
- package/skills/i3-enterprise-sop/references/verification/review-output.schema.json +0 -155
- package/skills/i3-enterprise-sop/references/verification/review_handoff.py +0 -329
|
@@ -1,17 +0,0 @@
|
|
|
1
|
-
{
|
|
2
|
-
"schemaVersion": 1,
|
|
3
|
-
"resourceVersion": "1.0.0",
|
|
4
|
-
"kind": "directory-standard",
|
|
5
|
-
"standard": "directory-standard.md",
|
|
6
|
-
"adoption": "adoption.md",
|
|
7
|
-
"layouts": [
|
|
8
|
-
{
|
|
9
|
-
"id": "pbc-composite",
|
|
10
|
-
"description": "PBC组合工程,按需映射前端、后端、Agent和任务工程"
|
|
11
|
-
},
|
|
12
|
-
{
|
|
13
|
-
"id": "agent-standalone",
|
|
14
|
-
"description": "独立Agent工程,允许采用框架原有的根目录布局"
|
|
15
|
-
}
|
|
16
|
-
]
|
|
17
|
-
}
|
|
@@ -1,52 +0,0 @@
|
|
|
1
|
-
# 工程骨架资源入口
|
|
2
|
-
|
|
3
|
-
<!-- i3:zh-guide:start -->
|
|
4
|
-
## 中文使用说明
|
|
5
|
-
|
|
6
|
-
按下文完整工程步骤、检查项与验证条件执行。根据任务选择适用步骤,保留证据、风险和退出条件;正文示例中的英文标签在面向用户输出时译为中文。
|
|
7
|
-
|
|
8
|
-
默认使用简体中文解释、追问及生成报告;用户明确要求其他语言时可切换。原方法正文、引用、阈值和审批条件完整保留。代码标识、路径、命令、工具参数、JSON 键/枚举与原文引用保持原样。
|
|
9
|
-
<!-- i3:zh-guide:end -->
|
|
10
|
-
|
|
11
|
-
资源内容版本:1.0.0。定位:语言无关的工程目录规范。AD 确定工程与模块的落点,原 Plan 把路径写入任务,获准的原 Build 在这些位置实现,再核对实际文件。目录规范不要求先取得企业代码模板或选定统一技术栈。
|
|
12
|
-
|
|
13
|
-
## 1. 从哪里开始
|
|
14
|
-
|
|
15
|
-
1. 读 [目录规范](directory-standard.md),按实际项目选择 PBC 组合工程或独立 Agent 组织方式;只采用需要的工程目录。
|
|
16
|
-
2. 按 [采用与交接说明](adoption.md),在项目已有工程说明或 AD 中写明采用版本、实际路径和必要例外。
|
|
17
|
-
3. 把明确采用的 AD、公共技术规约及该说明交给原 Plan;计划经所需审阅后,由原 Build 或原 Build auto 按原有条件执行。
|
|
18
|
-
4. 按采用说明核对新增、修改文件的真实落点;构建、测试和业务验证仍执行各自原有要求。
|
|
19
|
-
|
|
20
|
-
现有项目规范优先,已有代码不为套目录批量迁移。安装资源、目录存在或 JSON 引用本身都不会自动启用企业 SOP,也不会使原 Plan/Build 自动读取本资源。必须在本次任务或已采用项目指引中明确引用。
|
|
21
|
-
|
|
22
|
-
## 2. 本资源包含什么
|
|
23
|
-
|
|
24
|
-
| 文件 | 用途 |
|
|
25
|
-
| --- | --- |
|
|
26
|
-
| [catalog.json](catalog.json) | 资源版本、目录规范及两类组织方式的索引 |
|
|
27
|
-
| [directory-standard.md](directory-standard.md) | 目录职责、命名、工程边界、共享内容及实际落点规则 |
|
|
28
|
-
| [adoption.md](adoption.md) | AD、原 Plan、原 Build 的交接,手动/JSON 引用及目录验收;§6 提供存量映射、规范选择性更新、人工保护和按需迁移说明 |
|
|
29
|
-
|
|
30
|
-
pbc-composite 与 agent-standalone 是目录组织方式。frontend、backend、agents、jobs 是可按需采用的工程类别;它们不表示本资源已提供或验证任何语言/框架的代码模板。
|
|
31
|
-
|
|
32
|
-
公共技术规约继续使用项目已有规范或企业 SOP 已有资源,本资源不另建技术权威。UI 原型模板仍用于交互与样式设计,生产工程由实际 AD、任务和技术栈确定。
|
|
33
|
-
|
|
34
|
-
## 3. 实施与采用边界
|
|
35
|
-
|
|
36
|
-
本资源归属于SOP Skill的references/engineering-skeleton,与公共技术规约共用同一资料根;不新增顶级Skill或命令,不改原版技能、命令、原型或Hook。原版 25 个 Skill/9 个命令与已发布版本的既有能力保留;整合 SOP 后的目标数量仍为 27/11/4。
|
|
37
|
-
|
|
38
|
-
业务 JSON 顶层仍为 schemaVersion、scope、selected。需要时沿用 selected 主题内已有 engineeringSkeleton,引用项目真实采用说明;直接给原 Plan 同一组实际路径也可。不另建 project.yaml、锁文件、任务数据库或候选登记流程。
|
|
39
|
-
|
|
40
|
-
目录规范作为SOP自有分发资源;原生命令的真实读取/实施效果、发行包与宿主安装、人工验收分别验证。该资源没有提供目录生成器或代码框架模板,也不声称用提示词即可硬性拦截所有越界写入。
|
|
41
|
-
|
|
42
|
-
## 4. 现有项目与规范更新从哪里开始
|
|
43
|
-
|
|
44
|
-
- 已有工程先按[采用说明 §6](adoption.md)只读映射实际目录和命令,复用 web、services 或框架根布局,不为统一示例搬源码或再造同名工程。
|
|
45
|
-
- 新资源只供比较。先读项目当前采用说明和本次明确的新来源,展示差异及受影响规格/任务;人可选择保留当前、部分采用或整体采用。没有明确采用就不写项目副本、JSON 或代码。
|
|
46
|
-
- 明确采用后,保留项目例外、人工条款和文件历史。使用项目既有说明或规格承载结果;不另建采用状态库,目录确需迁移再交原 Plan/获准 Build。
|
|
47
|
-
|
|
48
|
-
标准项目沿用自己的 SPEC 或等效规格,不因为采用目录规范就补企业 BRD/PRD/AD 或启用企业 SOP。企业项目按已选 AD/PRD 交接。手动路径继续可用;已有 JSON 只引用实际采用文件,不增加更新或迁移状态。
|
|
49
|
-
|
|
50
|
-
安装文件与项目采用副本需区分:直接改过安装目录的内容先识别并保留为项目资料,不把本说明当作安装器自动保护所有人工修改的证明。已选来源不可读或旧版本已被替换时,展示准确缺项和选择,不静默换源或宣称仍在用旧版。
|
|
51
|
-
|
|
52
|
-
本版补齐的是采用规则与可复制用法;实际模型读取、选择性更新、迁移、包/安装效果仍按各自证据验收,不以说明存在或版本号提高代替。
|
|
@@ -1,196 +0,0 @@
|
|
|
1
|
-
# JSON 交接与手动传递合同
|
|
2
|
-
|
|
3
|
-
<!-- i3:zh-guide:start -->
|
|
4
|
-
## 中文使用说明
|
|
5
|
-
|
|
6
|
-
按下文完整工程步骤、检查项与验证条件执行。根据任务选择适用步骤,保留证据、风险和退出条件;正文示例中的英文标签在面向用户输出时译为中文。
|
|
7
|
-
|
|
8
|
-
默认使用简体中文解释、追问及生成报告;用户明确要求其他语言时可切换。原方法正文、引用、阈值和审批条件完整保留。代码标识、路径、命令、工具参数、JSON 键/枚举与原文引用保持原样。
|
|
9
|
-
<!-- i3:zh-guide:end -->
|
|
10
|
-
|
|
11
|
-
合同版本:v0.8.2;资源组合:0.16.2。当前修订:只保留明确选用路径,新增Plan消费规则的源码/分发/真实验证分层记录,尚未发布。S06—S08旧候选相关证据保留原对象,不作为本修订验证。命令与 Skill 共用本合同,原专业方法、写权限和停轮不变。
|
|
12
|
-
|
|
13
|
-
## 1. 两步交接及路径基准
|
|
14
|
-
|
|
15
|
-
第一步按企业任务形成 BRD、同 PBC 多主题独立 PRD、各自 AD/TestCase 及必要辅助引用;第二步用本次实际选定集合承接 SPEC 六项,交原 Plan,再按获准任务进入原 Build/test/review/Ship。可以从已有 PRD、AD 或 Plan 接入,不补跑 BRD、不编造 EBC 或历史批准,一个主题就绪可独立交接。
|
|
16
|
-
|
|
17
|
-
资源模板、提示词和共用合同属于资料根;真实规范、业务文档和工程资产属于项目选择,不能互相冒充。一份清单对应明确的业务项目根与工作范围。建议位置 .i3/sop/{实际工作范围}/handoff.json,已有位置优先;多份清单并存先确定本次对象,不按文件名、更新时间或最高版本猜选。
|
|
18
|
-
|
|
19
|
-
清单内相对路径统一相对本次明确的业务项目根,不相对清单目录、资源根或临时 cwd。开始先从任务及已采用指引明确根并实际核对,迁移项目后重定根。明确提供的项目外资料可用绝对路径并在现有采用说明标来源/移植影响;不全盘查找或擅自复制。路径存在只是定位事实,还须读取正文核身份、版本、范围和直接上游。
|
|
20
|
-
|
|
21
|
-
## 2. 最小字段
|
|
22
|
-
|
|
23
|
-
| 字段 | 含义 | 约束 |
|
|
24
|
-
| --- | --- | --- |
|
|
25
|
-
| schemaVersion | 清单格式,首期值 1 | 不等于软件、模板或业务文档版本;未知格式只读报告差异,不自动迁移 |
|
|
26
|
-
| scope | 实际工作范围,work 必填,已知 ebc 才写 | 结合明确的项目根定位,不推断能力登记或历史 |
|
|
27
|
-
| selected | 已明确选定且实际读过的真实输入引用 | 空对象可用;选择不代表批准 |
|
|
28
|
-
|
|
29
|
-
3.0 清单顶层只保留 schemaVersion、scope、selected,不生成 candidates 或 delivery,不执行候选登记或撤回。生成文档后展示实际路径,明确选用后才写 selected。原 Plan 保存 tasks/plan.md 与默认 tasks/todo.md,或在计划中说明唯一任务目标;Build 按获准任务继续,产物不重复回写 JSON。
|
|
30
|
-
|
|
31
|
-
首次准备格式如下,仅表达范围,无未来路径。此示例不是本包的真实业务清单,也不由安装自动创建。
|
|
32
|
-
|
|
33
|
-
```json
|
|
34
|
-
{
|
|
35
|
-
"schemaVersion": 1,
|
|
36
|
-
"scope": {"work": "巡检管理任务编排"},
|
|
37
|
-
"selected": {}
|
|
38
|
-
}
|
|
39
|
-
```
|
|
40
|
-
|
|
41
|
-
selected 可有 brd、technicalBaseline 以及 topics。每个主题按 capabilityId 和 prdId 共同区分;未知身份先核对,不补造。topics 内可有 prd、ad、testCase、engineeringSkeleton、prototype 和 contracts。单项文档引用用字符串路径,contracts用路径数组,按需存在,不预填。一个主题多个 PRD 版本为不同候选,主题身份不变;不同主题独立版本,不强制 PRD/AD/TestCase 同号。
|
|
42
|
-
|
|
43
|
-
prototype、engineeringSkeleton、contracts 等配套仍按实际选用情况记录在主题中。旧清单中的 candidates、delivery 仅兼容读取,不参与当前输入选择;只读操作不改旧稿,明确选用写入时保存原始历史并移除这两个旧字段。其他未知顶层扩展不静默删除,应先说明用途或手动迁移;scope/selected 内的人工内容保留。不复制正文、任务完成率、approved、passed、审批结论或会话摘要。
|
|
44
|
-
|
|
45
|
-
文档版本从选定文件名与正文回读核对,不另维护一套容易失配的版本值。TestCase为Plan可选输入:没有独立文件则省略字段;AD/已采用测试规范需承接本次验证要求,Plan可安排补齐设计。工程骨架引用真实采用说明或模板/源码,AD目录图不等于可应用资产;Build应用验证后才有真实工程根和相关锁。
|
|
46
|
-
|
|
47
|
-
基础交接不强制 SHA256,同路径人工修改允许;摘要、版本和旧审阅都不能替代当前正文。工程已有契约锁、模板生成基线或不可变证据的摘要机制仍保留,不由本合同删除。
|
|
48
|
-
|
|
49
|
-
## 3. 生成、登记和选择时点
|
|
50
|
-
|
|
51
|
-
以下为文档审阅到明确选用的交接规则;本次源码修订未测试。同主题改选仍用[受控预览](selection-handoff.md),手动传递保留。
|
|
52
|
-
|
|
53
|
-
| 时点 | 拟实现的登记动作 | 停点与边界 |
|
|
54
|
-
| --- | --- | --- |
|
|
55
|
-
| 首次明确采用文档 | 明确项目根/范围和清单位置;只有本次允许写清单时才初始化并记录选定引用 | 不在生成待审稿、安装或只读任务中创建清单;选用不代替原方法认可 |
|
|
56
|
-
| 从已有 PRD/AD/Plan 接入 | 回读实际材料及范围,明确采用后可登记所选输入;Plan沿用原产物约定 | 不要求先有 BRD 或补历史批准,不默认认领所有文件 |
|
|
57
|
-
| 成功生成或明确委托修订 | 最后编辑后回读最终稿,展示真实路径并交审 | 不登记候选、不自动改 selected;原方法要求停轮时立即停轮 |
|
|
58
|
-
| 用户明确选用某稿 | 回读对象与配套,按已明确范围更新 selected;已有选择可复用 | 留清单旧稿和业务旧稿,选择不代批准;持久选择不能由当次临时覆盖推定 |
|
|
59
|
-
| 原 Plan 或后续工程产物完成 | 按原方法保存计划、唯一任务目标及实际工程/报告,不回写 delivery | 原方法不天然读写清单;后续按原产物路径和任务来源交接,保留原停点 |
|
|
60
|
-
| guide/status/review/recheck 或其他只读任务 | 不创建目录、清单、报告或采用记录 | 只在会话报告,获准调用者另存,零项目写入 |
|
|
61
|
-
|
|
62
|
-
文档生成/修订只写本次明确目标及必要已授权历史,交审停轮;选用登记是另项获准作业。显式plan只写原规划产物,不改业务稿或清单,不向原Skill/命令注入额外权限。AD准备优先读既有规范和实际技术栈/骨架选择;缺规范时可建议来源或最小候选,用户可手动调整,不能为填清单静默生成总规约或切换工程。
|
|
63
|
-
|
|
64
|
-
## 4. 实际读取与冲突处理
|
|
65
|
-
|
|
66
|
-
1. 先判断本次流程。明确标准任务不读取/使用企业清单、模板或提示词;资源存在不激活企业 SOP。
|
|
67
|
-
2. 明确唯一清单、项目根和本次主题;只读本次选定材料及必要依赖。新稿不自动采用,未选版本或另一个主题不替换当前稿。读清单后必须实际读对应正文、采用依据和必要契约。
|
|
68
|
-
3. 本轮明确手动路径可覆盖相同角色的当次输入,说明与现有选择的差异;不自动改 JSON/项目采用。来源间矛盾、未知格式或同主题重复选择不猜优先,报告具体范围等待明确。
|
|
69
|
-
4. Plan前核本范围六项、依赖、已有未完计划及必要真实认可。Plan/任务保留实际来源、主题、需求/AC及验证依据,不只留下可变 JSON 链接。原 tasks/plan.md、唯一 todo/tracker及只规划停点保持。
|
|
70
|
-
5. Build以获准 Plan任务为依据,回读关联实际设计。JSON或同路径内容已变时先核与计划差异;不能让旧任务静默按新设计施工,也不无故重置无关任务。
|
|
71
|
-
6. 缺文件、不可读、主题/版本/上游矛盾或契约失效,报告准确路径、问题和依赖影响;无静默全局/历史/最新版兜底。仅限制依赖范围,可独立部分不全量阻断。实际测试、代码审查和Ship各保留原条件,GO不等于发布授权。
|
|
72
|
-
|
|
73
|
-
原 /i3-spec 的默认根 SPEC.md 与原 /i3-build auto 的固定规格/Git条件仍保留;等效企业规格使用适用原方法交接,不写影子 SPEC、改原命令或使用 JSON 绕过限制。新项目的工程规格按 spec/ 组织,允许继续使用原Plan、逐任务Build及原Build auto;后者仍保留其完整规格、Git与计划认可条件。企业跨阶段auto留3.1.0,两者不混同。
|
|
74
|
-
|
|
75
|
-
## 5. 修改保护及失败恢复
|
|
76
|
-
|
|
77
|
-
本片可执行的最小恢复顺序、适用读集与复制提示见[恢复规则](recovery-contract.md)。复用本合同§8的init/select/resolve 三操作,不另建恢复状态库。只补登记与修订业务稿是不同任务;部分稿保留且不登记,工具失败先报告停止,后续获准作业回读后只补登记。status/恢复不调用Spec生成,但仍完成五项共用读取及实际用于定位的安装身份核对。
|
|
78
|
-
|
|
79
|
-
| 情况 | 处理 |
|
|
80
|
-
| --- | --- |
|
|
81
|
-
| 项目自改模板/提示词/规范/同路径正文 | 读当前内容、保留修改及来源,核影响;不按发行摘要还原,不继承未核对的旧批准 |
|
|
82
|
-
| 明确选用但登记失败 | 保留现有文档与旧清单,说明准确路径及失败;后续只补已明确选用的引用,不重新生成或覆盖文档 |
|
|
83
|
-
| 文档失败或只有部分稿 | 不选用部分稿,不切换选择;部分稿及失败保留作业记录 |
|
|
84
|
-
| 重复选用 | 相同主题与路径复用,不制造新业务版本/任务;需要清理旧字段时保留原始历史 |
|
|
85
|
-
| 清单人工扩展或其他会话修改 | 保留未知字段和不属于本次的条目;写前回读,发现冲突停写,不用模板空表替换现稿 |
|
|
86
|
-
| 无法保证原子并发更新 | 如实报告能力边界、保留差异与恢复依据;不能只凭提示词宣称消除并发覆盖 |
|
|
87
|
-
|
|
88
|
-
清单登记与业务正文写入为可分别失败的动作,不宣称事务保证。更新前保存可回读旧稿,最后写后实际回读。未核实的外部动作不盲重试,不建设另一套审批/任务状态数据库。实际保护和恢复须在 S06/S08 验证,B04的只读定位证据不代替写入测试。
|
|
89
|
-
|
|
90
|
-
## 6. 无 JSON 的手动方式
|
|
91
|
-
|
|
92
|
-
没有清单也可使用原命令或适用 Skill 加明确企业任务和真实路径,不强制安装登记程序、建清单、补跑BRD或改项目指引。手动路径同样读取正文并核身份、配套与缺口;是否持久登记由实际意图决定,纯手动任务不写 JSON。
|
|
93
|
-
|
|
94
|
-
```text
|
|
95
|
-
本次使用企业SOP资料,按我给的实际路径手动交接,不创建JSON。
|
|
96
|
-
请读取 <本次PRD>、<配套AD>、<已采用公共规范>、<骨架采用说明或真实工程模板> 及相关代码,核对本主题身份、直接上游、SPEC六项、依赖和未完计划。
|
|
97
|
-
本轮只准备原Plan的输入摘要,保留实际来源及Q,交我审阅;已有TestCase就引用,没有则从AD/已采用测试规范核验证要求并安排补齐,不统一阻断规划。
|
|
98
|
-
```
|
|
99
|
-
|
|
100
|
-
此为准备任务;实际调用原 /i3-plan 或规划 Skill 时仍遵守其完整规则。命令/Skill共享引用含义、范围与停点,不假定所有宿主slash参数和工具一致。当前合同不证明新入口或原Plan/Build实际集成,相关验证留S10/S11。
|
|
101
|
-
|
|
102
|
-
## 7. 新增、修改、撤回与退役的引用差量
|
|
103
|
-
|
|
104
|
-
完整规则读[生命周期合同](lifecycle-contract.md)。schemaVersion仍1,不增加审批或任务状态。新主题/新版本保存后只展示实际路径,明确选用才更新对应selected及真实配套;未采用稿件没有JSON撤回操作。部分需求撤销保留完整主题;整个未实施主题的选择撤销另核任务与消费者,共用引用和其他主题保留。业务旧稿、选择前清单及依据留存,历史不默认采用。
|
|
105
|
-
|
|
106
|
-
已实现功能的退役目标不代表生产已经切换;工程根、旧报告及已完成任务仍是历史事实。路径缺失是断引用,不推定撤销,不自动找高版本/history替换。只读影响预览不写任何项目对象。无JSON的手动交接含同样的变更意图、真实路径、旧新依据和原方法停点,不能因手动方式跳过必要正文读取或任务保护。
|
|
107
|
-
|
|
108
|
-
## 8. S06最小辅助与边界
|
|
109
|
-
|
|
110
|
-
工具为本资料根的[handoff.py](handoff.py),版本v0.2.0,Python 3.9+标准库即可运行;先以`python3 <资料根>/handoff.py --help`核对接口。原版方法不导入或自动调用该工具,业务文档及原Plan/任务文件不由工具改写。
|
|
111
|
-
|
|
112
|
-
| 操作 | 已实现结果 | 本片边界 |
|
|
113
|
-
| --- | --- | --- |
|
|
114
|
-
| init | 显式项目根、清单位置与work创建最小对象;同范围且已是三字段时重复调用不写;清理旧字段时保存原始历史 | 不自动扫描其他清单或推断EBC;scope不同拒绝覆盖 |
|
|
115
|
-
| select | 直接登记明确初次选用或复用相同选择;同PBC不同prdId独立 | 不需要候选预登记;不同既有路径仍拒绝替换,配套及改选沿用准确预览;选用不是批准 |
|
|
116
|
-
| resolve | 只读核选定路径;多主题要求明确身份 | 不读未选高版本或自动补TestCase;不改变Plan,语义和直接上游由调用方核 |
|
|
117
|
-
| resolve+manual | 没有清单也可按明确路径只读解析;已有清单可作当次覆盖 | 不创建JSON、目录、历史或采用关系;同角色重复手动路径报歧义 |
|
|
118
|
-
|
|
119
|
-
引用角色:全局brd、technicalBaseline;主题prd、ad、testCase、prototype、engineeringSkeleton、contracts。主题引用需要capabilityId与prdId。相对路径按项目根,显式采用的项目外绝对路径只读引用,不复制;工程骨架可指真实采用文件或源码目录,仍须另读其实际说明。
|
|
120
|
-
|
|
121
|
-
每次实际清单变化前保存同目录history旧稿,保留scope/selected内的人工内容与其他主题;未知顶层扩展先明确用途,不自动清理。写后脚本完整回读清单;调用方还须回读实际差量及必要旧稿。清单和history写入路径均拒绝符号链接越界。协作工具有基础排他锁、写前比对和原子替换;不保证与任意人工编辑器之间的事务,不自动清理旧锁或恢复失败。业务稿写入与JSON登记也不是跨文件事务。
|
|
122
|
-
|
|
123
|
-
最小JSON不增加hash、批准或任务状态字段。同路径人工改稿后重新读取当前正文,不因旧路径或旧报告沿用认可。部分稿/失败的完成判定由调用方依据真实任务及回读证据负责;CLI成功只能说明路径登记,不能证明业务完成。
|
|
124
|
-
|
|
125
|
-
S06原生验证仅证明旧版当时用法,不证明本次三字段和选用登记修订;S07命令、S08完整改选与恢复、S09独立审查、S10完整双入口矩阵、S11原Plan/Build实际消费和I4/I5工程仍分别取证。
|
|
126
|
-
|
|
127
|
-
## 9. 真实调用与执行报告
|
|
128
|
-
|
|
129
|
-
工具调用一经提交就是真实尝试;description中的“占位”“不执行”等文字不取消调用。状态说明、计划和待办只用会话文字,不提交探测或占位命令。按本轮明确工具范围操作,所需输入先实际读完;使用辅助时先核准确的`--help`接口,再做获准登记。必要工具被拒或失败就报告并停止依赖动作,不扩大权限或改用旁路;误发无关调用被拒,应如实列出,不将其说成辅助不可用,也不重复尝试。
|
|
130
|
-
|
|
131
|
-
报告以真实tool_use/tool_result为依据,分别写清尝试、被拒、执行失败、成功及未确认;被拒也计入尝试。功能、写入边界、执行纪律及报告一致性分别判定。工具路径登记成功不能抵销其他偏差,模型自述不能代替轨迹或人工认可。
|
|
132
|
-
|
|
133
|
-
需要外层执行复核时,调用者事先固定唯一项目、辅助路径、清单、主题、允许的引用和必需动作;由外层按[校验说明](verification/readme.md)检查原始轨迹、独立核心审计和最终报告。执行状态仅存在会话/外层证据报告,不写入业务handoff.json,不新增审批或任务状态,也不改变原方法。
|
|
134
|
-
|
|
135
|
-
最终会话报告中附且仅附一个下列有界JSON块;每行对应本轮一条实际Bash尝试,ordinal从1连续编号,按真实顺序列全。operation只用help、init、select、resolve、other;status只用succeeded、blocked、failed、unconfirmed。禁止另加role等字段。长命令和来源由外层从轨迹保留,无须在此复制。下例为单次接口核对的格式示意,实际作业按真实次数展开:
|
|
136
|
-
|
|
137
|
-
<!-- i3-sop-execution-report -->
|
|
138
|
-
```json
|
|
139
|
-
{"schemaVersion":1,"shellAttempts":[{"ordinal":1,"operation":"help","status":"succeeded"}]}
|
|
140
|
-
```
|
|
141
|
-
<!-- /i3-sop-execution-report -->
|
|
142
|
-
|
|
143
|
-
没有回执或回执不支持时使用unconfirmed,不猜成功;权限明确拒绝为blocked,工具/进程或辅助明确失败为failed,实际成功回执为succeeded。外层检查通过仍需人工审阅;普通非Bash作业不被本CodeBuddy专用校验器强制增加调用。历史自由文字报告保持原样,问题另存校订说明,不追溯要求旧轮满足新增格式。
|
|
144
|
-
|
|
145
|
-
上述shellAttempts只适用于直接Python辅助操作的既有S06校验。外层验证原生Skill、状态、Plan或Build前置时,显式选择[原生执行证据配置](verification/readme.md#原生方法与执行报告),不把原校验器放宽为任意Bash守卫。该配置从真实轨迹提取全部工具尝试,最终报告只列失败/被拒/未确认尝试、调用者指定的输入核查和门禁状态;不要求模型手抄成功调用计数或工具ID。
|
|
146
|
-
|
|
147
|
-
成功标志与正文矛盾时保留矛盾:例如Skill回执虽is_error=false但明确返回Error,不能报成功。路径存在、AD列有引用、宿主可能自动注入规则,都不证明已显式全文读取。已核/未核与未尝试分别写清;“无写入”“无Bash”“无工具调用”含义不同。报告的机器可核部分通过,不代表自由文字、设计语义或业务批准通过。
|
|
148
|
-
|
|
149
|
-
## 10. 从选定 AD 到原 Plan、Build 的输入合同
|
|
150
|
-
|
|
151
|
-
新项目业务文件默认在 spec/{能力}/,已有已采用路径不自动搬迁。资源根不变;JSON仍schemaVersion 1,不新增Spec角色、业务摘要、hash或批准/任务状态。工程入口由主题selected.ad或本轮手动AD路径定位;实际读取该AD、其准确PRD、规范/契约条款、骨架来源及必要代码。没有AD或六项不足时报告依赖缺口,JSON解析成功不能代替工程规格检查。
|
|
152
|
-
|
|
153
|
-
生成文档后完整回读最终稿、展示路径并遵守原 Spec 的保存后停轮,不自动创建清单。用户明确采用后,获准交接作业才准备三字段清单并记录 selected;已有明确委托可直接承接,不重复询问。若登记失败只补准确选用引用,文档成功与选用登记成功分别报告。
|
|
154
|
-
|
|
155
|
-
显式采用的项目指引可记录工作范围、capabilityId+prdId和唯一清单,作为原Plan的查找线索;它不将标准任务切为SOP。若没有确定范围、多个主题可选或指引失效,原Plan应澄清/由用户手动给准确路径,不静默取最高版。原方法不会天然解析或写回JSON。
|
|
156
|
-
|
|
157
|
-
可复制的最短手动交接:
|
|
158
|
-
|
|
159
|
-
```text
|
|
160
|
-
/i3-plan 本次使用企业SOP的等效规格。只规划:spec/巡检管理/巡检管理-任务编排-AD_v0.0.3.md 及其明确引用的PRD、已采用规范/契约、骨架来源和相关代码。完整核本主题SPEC六项、FR/AC、依赖和验证;TestCase按需。保留真实来源到tasks/plan.md与唯一任务目标,交我审阅,不实施。
|
|
161
|
-
```
|
|
162
|
-
|
|
163
|
-
有明确选用清单时可改为:
|
|
164
|
-
|
|
165
|
-
```text
|
|
166
|
-
/i3-plan 本次使用企业SOP。读取.i3/sop/巡检/handoff.json,仅选capabilityId=inspection、prdId=scheduling的AD及其必要配套;实际读正文并核直接上游/六项,不取候选或其他主题。按原方法规划并保留来源,交我审阅,不实施。
|
|
167
|
-
```
|
|
168
|
-
|
|
169
|
-
计划须保存真实输入路径/版本、主题、需求/AC及验证依据,不能仅保存一个可变清单链接。原默认产物、不同工作未完计划保护和人审停点保留;如使用原方法支持的外部tracker也只能有一个权威任务目标,并在原计划中说明。Plan 结果直接按原产物位置交接,不重复登记 JSON,不把缺少 delivery 列为交接缺口。
|
|
170
|
-
|
|
171
|
-
原 /i3-build 只执行已获准的下一任务;原 /i3-build auto须满足其允许的规格位置与有效内容、Git条件和全计划明确认可。特别是.i3/sop、CODEBUDDY.md、docs/engineering及安装目录等未提交变化不在默认允许规划产物内,触发原停点时呈现冲突由用户决定,不能加ignore、隐藏或擅自提交业务稿绕过。已获准的独立测试仓库提交只证明该仓库的工程行为,不等于产品发布。
|
|
172
|
-
|
|
173
|
-
Build前回读任务及关联实际设计,同路径或selected变化时核影响,受影响旧任务先由原Plan修订并获准,不用新稿偷换计划;无关任务和已完成历史保留。新会话回读真实来源与认可范围,不将模型自述、JSON或用例fixture当真人批准。按主题分组加载,必要共享约束仍完整覆盖。
|
|
174
|
-
|
|
175
|
-
## 11. 门禁对象、时点和允许范围
|
|
176
|
-
|
|
177
|
-
| 门禁 | 实际含义与时点 | 不应扩大或替代的事项 |
|
|
178
|
-
| --- | --- | --- |
|
|
179
|
-
| 原Spec保存后人审 | 起草/修订保存并完成最终回读后,按原方法停轮交审;后续采用与规划遵循真实审阅决定 | 不因外层检查通过继续自动调用Plan、Build或补登记 |
|
|
180
|
-
| 明确选用登记 | 用户明确采用准确文档与配套,并允许写清单时才更新selected;原方法要求停轮则后续获准作业再做 | 新稿存在不构成选用;旧候选登记委托不构成选用委托;选用不等于Plan批准或开工许可 |
|
|
181
|
-
| 局部Q/依赖缺口 | 写清影响的具体要求、契约、任务和最晚决定时点;未知保留待核 | 不把局部Q统一扩大成全部规划/登记禁令,也不跳过实际受影响任务前的决定 |
|
|
182
|
-
| SOP Plan身份/直接上游冲突 | AD与本次准确PRD、所选范围的能力/主题标识或直接上游路径/PRD版本矛盾时,先停,不加载原规划、不写plan/todo或候选计划 | 疑似头部笔误、正文相似、文件已选或待审状态不代替人工处理;非阻断Q条款不能越过此停点,PRD/AD不强制同号 |
|
|
183
|
-
| 原Plan审阅/批准 | 实际计划与唯一任务目标形成后,由真人明确批准具体版本、范围及检查点 | Spec认可、JSON选择、模型报告和测试fixture不能代替Plan批准 |
|
|
184
|
-
| 原Build工程前置 | 保留原命令方法加载要求;auto核有效规格、真实Git基线和全计划明确认可 | 安全停止正确不代表全部调用义务已满足;缺后续实现证据不写成已执行TDD/构建/提交 |
|
|
185
|
-
| 项目额外检查点 | 若计划要求任务完成后、提交前再次人审,应在计划审阅时明确是否采用、批准对象和时点 | 不静默新增检查点,同时承诺原auto无额外停轮;不改原Build来迁就候选Plan措辞 |
|
|
186
|
-
| 测试/审查/Ship | 沿用各原方法的真实输入、质量、风险及授权条件;就绪与实际执行分别取证 | 外层报告、候选稿或Ship就绪结论不构成发布/生产操作许可 |
|
|
187
|
-
|
|
188
|
-
这些门禁说明不新增业务JSON审批状态或替代原版规则。[单次受控交接](controlled-handoff.md)提供显式 CodeBuddy 入口,只对该次预检到明确选用登记或[同主题准确改选](selection-handoff.md)实施程序约束,不自动挂载其他会话或原版命令。改选先预览配套原文证据和Plan影响,再绑定该次明确选择;不更新原Plan或迁移批准。有真实项目约束冲突时只标注,给原因、推荐与可选操作,由使用者决定;业务稿与已完成任务不自动改写。
|
|
189
|
-
|
|
190
|
-
## 12. 显式SOP Plan消费
|
|
191
|
-
|
|
192
|
-
/i3-sop plan与显式Skill的plan按[同一规划合同](plan-handoff.md)确定唯一范围,复用resolve或明确手动路径,只读消费selected。计划输入不止AD,还包含准确PRD、实际规范/契约、工程采用和相关代码;已有适用TestCase/原型按需,SPEC六项仍核。实际调用原规划Skill并履行当前原Plan命令义务,保留原plan/todo、不同未完任务保护、回读与人审停轮。
|
|
193
|
-
|
|
194
|
-
该动作不初始化或写回JSON,不登记Plan产物,不代批准或自动Build。无JSON不强制创建,坏JSON不静默换源;标准原/i3-plan保持原使用方式。工具只解析路径,身份/版本/直接上游及真实业务决定仍由实际原文与来源核对。
|
|
195
|
-
|
|
196
|
-
手动和JSON Plan共用规划合同的首批必读及检查点;手动不豁免README、阶段索引、共用合同、交接合同与规划合同全文。身份或直接上游冲突优先于独立部分规划,先给证据和处理建议,不修改业务稿或JSON、不输出plan/todo;人工处理后重新核对再规划。此规则与§11局部Q的适用范围分开,不增加业务JSON状态或接管原版方法。
|
|
@@ -1,91 +0,0 @@
|
|
|
1
|
-
# 新增、修改、撤销需求与功能退役合同
|
|
2
|
-
|
|
3
|
-
<!-- i3:zh-guide:start -->
|
|
4
|
-
## 中文使用说明
|
|
5
|
-
|
|
6
|
-
按下文完整工程步骤、检查项与验证条件执行。根据任务选择适用步骤,保留证据、风险和退出条件;正文示例中的英文标签在面向用户输出时译为中文。
|
|
7
|
-
|
|
8
|
-
默认使用简体中文解释、追问及生成报告;用户明确要求其他语言时可切换。原方法正文、引用、阈值和审批条件完整保留。代码标识、路径、命令、工具参数、JSON 键/枚举与原文引用保持原样。
|
|
9
|
-
<!-- i3:zh-guide:end -->
|
|
10
|
-
|
|
11
|
-
合同版本:v0.1.1;资源组合:0.6.1。仅为明确企业作业使用的自有资料规则,不是新Skill/命令、JSON程序或工程执行器。资源定位见[入口](readme.md),引用字段见[交接合同](handoff-contract.md),文档职责见[共用合同](template-contracts.md)。三份合同共同使用,业务JSON仍schemaVersion1,无新增必填状态字段。
|
|
12
|
-
|
|
13
|
-
## 1. 先分清意图和事实
|
|
14
|
-
|
|
15
|
-
| 意图 | 本次规格责任 | 工程责任 |
|
|
16
|
-
| --- | --- | --- |
|
|
17
|
-
| 新增 | 同主题补行为或为独立目标新建prdId;复用相容BRD/公共规范,不按页面拆PBC | 本主题足以交接后增量交原Plan,不重新生成整个工程 |
|
|
18
|
-
| 修改 | 先读现稿、人工修改与真实来源,保留稳定需求/AC,输出完整当前目标和新增/修改/保留/撤销映射 | 核配套、任务、已实现和消费者影响;文字更正不机械全链升版 |
|
|
19
|
-
| 撤销需求 | 明确单项、部分范围或整个主题;保留仍有效内容与撤销依据 | 未实施取消待办,进行中核真实进展,已实现部分需要新的移除/迁移任务 |
|
|
20
|
-
| 功能退役 | 已实现或运行功能的停止/替代目标;假设与真实状态分开 | 新的兼容、移除、数据/任务迁移和回归;删PRD文件不表示代码或生产已退役 |
|
|
21
|
-
|
|
22
|
-
当前有效目标、任务实际状态、已发生工程事实分别从真实来源回读。selected仅表示明确采用的输入,不证明运行已切换或测试通过;工程及报告沿用原方法,不回写delivery。讨论、status、review/recheck和只读预览零项目写入。
|
|
23
|
-
|
|
24
|
-
## 2. 各阶段承接及来源
|
|
25
|
-
|
|
26
|
-
| 产物 | 必须核对的本阶段责任 |
|
|
27
|
-
| --- | --- |
|
|
28
|
-
| BRD | 业务目标/能力边界/跨PBC责任改变才修订;同PBC新增主题可复用已有BRD,不补造认可 |
|
|
29
|
-
| PRD | 固定capabilityId/prdId与仍有效FR/AC;完整当前目标、新旧映射、直接来源;部分撤销不删整个主题 |
|
|
30
|
-
| AD | 对应一份明确主题PRD,保留技术/功能/ER三图及详设;准确公共规范、正式契约、数据owner、消费者、实际骨架及影响/恢复 |
|
|
31
|
-
| TestCase | 同时核产品预期及AD技术判据;新增/变更、撤销后不可用或替代、迁移/失败恢复、保留行为和跨主题回归 |
|
|
32
|
-
|
|
33
|
-
一能力一目录,主题独立版本、配套不强制同号。允许同路径人工编辑,先读当前正文、旧稿和真实变更依据;不强制SHA、不恢复发行模板,不仅凭路径/版本继承旧认可。没有旧稿或未知业务决定,只限制依赖范围,不编造历史。
|
|
34
|
-
|
|
35
|
-
公共规范、共享契约、数据与状态有各自权威,必要直接及传递消费者明确;一个主题变化不自动改全部AD或删除共享底座。原型按需、AD可并行,已采用原型核appliesTo及影响,不借SOP改其登记。TestCase是Plan可选输入,验证要求须足够,缺文件可安排设计补齐,不取消企业测试设计交付。
|
|
36
|
-
|
|
37
|
-
## 3. 选用引用与需求变更
|
|
38
|
-
|
|
39
|
-
| 时点/对象 | 处理 |
|
|
40
|
-
| --- | --- |
|
|
41
|
-
| 本次生成或修订 | 完成后回读、保存并展示真实路径,按原方法交审;不自动更新JSON |
|
|
42
|
-
| 新主题/新版本 | 文档保留独立版本,明确采用后才登记selected;不自动替换Plan,不预填未来配套 |
|
|
43
|
-
| 明确选择 | 核正文和实际配套,保留选择前清单;不适用的旧配套移出本次选择并报缺口,不假配新PRD |
|
|
44
|
-
| 部分需求撤销 | 由完整新PRD表达撤销编号和保留行为,不删除整个topic;明确选用后再更新引用 |
|
|
45
|
-
| 整个未实施主题撤销 | 核任务与消费者,只处理本主题明确需要撤销的当前选择;其他主题及仍被消费的公共引用保持 |
|
|
46
|
-
| 已实现功能退役 | 选择真实退役目标,不用selected证明生产停用;保留旧运行依据、工程根和真实报告 |
|
|
47
|
-
| 已选路径缺失/移动 | 报具体断引用;新位置实际回读后才更新,缺失不推定撤销,不猜最高版或找history兜底 |
|
|
48
|
-
|
|
49
|
-
业务JSON不加approved/cancelled/完成率;理由和旧新映射可在项目已有PRD、AD影响表、Plan/唯一tracker或已有决定记录中表达,不强制新变更文件。清单只保存引用,不接管任务状态或生产状态。物理删除需要明确文件操作任务和引用/保留检查,不能顺带删除仍被Plan/报告引用的文件。
|
|
50
|
-
|
|
51
|
-
本资源不实现登记:S06/S08另建有限辅助并验证。文档成功、登记失败保留文档和旧清单,后续只补引用;只读作业不能补写清单。多个作业无整体事务保证,写前回读并发变化则停覆盖、保留差异;不凭提示词宣称消除竞态。
|
|
52
|
-
|
|
53
|
-
## 4. 原Plan与任务状态
|
|
54
|
-
|
|
55
|
-
Plan仍是tasks/plan.md,任务仍为默认tasks/todo.md或项目明确指定唯一tracker。原方法已有“同一工作重规划原位更新;不同工作存在未完计划时停止处理冲突”,不得覆盖/搬走旧计划、批量关闭其他工作或复制竞争待办。
|
|
56
|
-
|
|
57
|
-
| 实际任务状态 | 增量交接要求 |
|
|
58
|
-
| --- | --- |
|
|
59
|
-
| 已完成 | 原ID、来源、完成状态及证据保留;要移除该功能时新建退役任务,不撤勾或改写成按新版本完成 |
|
|
60
|
-
| 未开始且仍有效 | 保留;只对受影响来源、依赖、范围与验收作获准调整,不无故重建全部ID |
|
|
61
|
-
| 未开始且明确取消 | 退出有效未完集合,保留原ID、取消依据和依赖处理;不勾为完成,不让下一次Build误领 |
|
|
62
|
-
| 进行中/部分实现 | 核真实文件、进展、副作用和未知,停在受影响安全边界,保留人工工作;不自动reset/回滚/删工程 |
|
|
63
|
-
| 其他未完工作 | 原方法停止说明冲突,由用户决定范围,不越权修改 |
|
|
64
|
-
|
|
65
|
-
默认Markdown取消记录可用同一Plan/todo的独立文字区,不使用待办或完成复选框;具体形态须在S11实际验证Build不会误领。外部tracker按其真实支持及本次授权表达取消/不实施,不能当Done,也不复制本地状态表。恢复同语义需求是新的明确变更,保留恢复关系,不复用旧取消任务当新完成证据。
|
|
66
|
-
|
|
67
|
-
资料作业只交本次变更意图、准确文档及范围、现有代码/任务事实、受影响/保留需求和AC、共享消费者、验证/恢复与Q。后续明确调用原Plan才修订计划;任务记录实际路径及编号,不只留下可变JSON链接。只改JSON不算任务已取消,资料作业不直接修改Plan/tracker。
|
|
68
|
-
|
|
69
|
-
## 5. 原Build、工程与退役
|
|
70
|
-
|
|
71
|
-
Build按获准Plan的具体任务回读实际来源。新候选、selected改变或同路径改稿不自动切设计;下一受影响任务前核计划差量,未调整时不按旧稿实现撤销内容,也不偷偷按新稿施工。无关且已获准任务按依赖及原方法可继续,不全量重置。没有监测/锁能力时不承诺即时中断其他会话;在实际检查点处理,S11验证真实接点。
|
|
72
|
-
|
|
73
|
-
AD选择真实骨架,Plan安排,获准Build才应用/验证。保留pbc-composite/agent-standalone及frontend/backend/agents/jobs、contracts/shared/tests/delivery职责,既有人工代码、原始生成基线和有效工程锁不整仓覆盖。JSON或AD修改不证明工程已生成/更新;I4/I5实际工程与存量更新另验。
|
|
74
|
-
|
|
75
|
-
退役按实际适用范围明确:入口和替代/拒绝行为;API/事件及已知提供消费双方、兼容窗口/在途请求;共享数据、保留/迁移和权限;jobs/队列/Agent工具与重试;工程配置/部署/观察;恢复点、补偿和不可逆限制。未知结果先调查,不盲重试迁移或写操作。代码回滚不等于已删数据恢复,撤销需求不授权删库;具体工程/生产动作按真实授权和原风险停点执行。
|
|
76
|
-
|
|
77
|
-
## 6. 测试、审查和Ship
|
|
78
|
-
|
|
79
|
-
TestCase为设计,原TDD/适用测试及test负责真实测试代码/运行,原代码review保持自身方法;不把企业只读文档审查套到原review。文档审查只读标注真实问题、位置、来源、影响和最小建议;用户可人工修订、明确委托、有据不采纳或保留Q,不自动改实例或取消任务。
|
|
80
|
-
|
|
81
|
-
正式撤销/退役后,原正向测试可按真实新目标更新,但保留旧用例/原始报告和变更依据,补停用/拒绝/替代、迁移/恢复及未受影响回归。不能删失败用例、改阈值或降低覆盖制造通过,不以mock关闭必需真实集成。
|
|
82
|
-
|
|
83
|
-
报告绑定实际runId、输入/配套、代码或制品、环境/依赖、执行主体、原始证据和缺陷;失败、阻断、未运行、未知分别保留。审查报告由获准调用者按原约定另存,不要求在JSON重复登记。Ship GO只说明就绪,实际发布/部署/生产退役许可和回执分别取证。
|
|
84
|
-
|
|
85
|
-
## 7. 手动方式和任务结束
|
|
86
|
-
|
|
87
|
-
无JSON时仍可原命令/适用Skill+明确任务+真实路径,读取原文和变更依据,不强制建清单、补BRD、安装登记程序或修改项目默认。不增加add/delete/retire操作;未来/i3-sop和显式Skill共用相同阶段规则,using不增路由,跨阶段auto留3.1.0。
|
|
88
|
-
|
|
89
|
-
本次结束说明真实文档/来源/读写、意图与影响、文档存在/选用/任务/运行事实、Q和未执行范围。原方法的澄清、内容、工具、认可和停轮保留;一次单阶段作业不自动连改下一文档、Plan、代码、生产或发布。资源、严格读取、完整生成、独立审查、实际工程、人审和发布各自取证,规则存在不等于已实现稳定自动化。
|
|
90
|
-
|
|
91
|
-
B05收口补充:影响结论绑定实际核查范围;对未知消费者、历史数据和恢复条件保留待核,不写成无消费者/无需迁移。回读完成以[共用合同](template-contracts.md)末次编辑后全文要求为准,外层工具仅校验证据,不授予JSON、任务、代码或生产写入。
|
|
@@ -1,73 +0,0 @@
|
|
|
1
|
-
# SOP Plan:选定规格交给原规划能力
|
|
2
|
-
|
|
3
|
-
<!-- i3:zh-guide:start -->
|
|
4
|
-
## 中文使用说明
|
|
5
|
-
|
|
6
|
-
按下文完整工程步骤、检查项与验证条件执行。根据任务选择适用步骤,保留证据、风险和退出条件;正文示例中的英文标签在面向用户输出时译为中文。
|
|
7
|
-
|
|
8
|
-
默认使用简体中文解释、追问及生成报告;用户明确要求其他语言时可切换。原方法正文、引用、阈值和审批条件完整保留。代码标识、路径、命令、工具参数、JSON 键/枚举与原文引用保持原样。
|
|
9
|
-
<!-- i3:zh-guide:end -->
|
|
10
|
-
|
|
11
|
-
合同版本:v0.2.2。`/i3-sop plan` 与显式 i3-enterprise-sop 的plan动作共用本合同,只做一次明确规划。四阶段文档仍由原Spec生成/修订;plan不生成第五份规格,不调用Build、测试执行、提交或发布。普通标准 `/i3-plan` 保持原入口,不强制读取本资料或handoff。
|
|
12
|
-
|
|
13
|
-
**统一读取准备:**JSON与手动路径共用同一准备环节;手动只免JSON解析,不免共用规则。先从项目实际采用记录确定所选资料根;没有选定副本时,从本次实际加载的SOP Skill目录下references/进入。CodeBuddy以 `.codebuddy/.i3-composer-agent.json` 的name/version/scope、catalog.skills及当前Skill精确assets核身份,不用resources.references推导SOP根。原 `/i3-plan` 命令可用 `.codebuddy/commands/*plan*` 定位;无项目安装才查同宿主真实全局登记,不读其他宿主副本。
|
|
14
|
-
|
|
15
|
-
**首批必读:**完整Read原 `/i3-plan` 命令正文,以及所选根readme.md、stages.json、template-contracts.md、handoff-contract.md、本plan-handoff.md。索引planHandoff.requiredResourceReads是共用文件名的同一清单,调用者和外层验证据此固定实际路径;不能只读最后一份,不用用户补内部路径。必要正文仍由模型实际读取,脚本解析索引不能冒充读取回执。项目自改资料优先,未确认完整覆盖时仍读其选定原件,不回退发行副本。
|
|
16
|
-
|
|
17
|
-
资料和目录定位用Read/Glob/Grep,不调用ls/find/mkdir等shell探测或试验权限。解析辅助仅在本次真实工具许可范围内使用,不将工具名可见视作任意命令获准;失败尝试保留且准确报告。此处约束SOP准备环节,不改原规划方法或增加权限。
|
|
18
|
-
|
|
19
|
-
**进入原规划前的检查点:**共用文件及原命令全文已读→准确业务/技术输入已读且身份/直接上游无冲突→实际加载原规划Skill成功→允许原plan/todo写入。缺读/部分读/失败先补齐,未齐停止;身份或上游冲突按§2.1先停,不因打算写待审稿绕过。原Skill已加载、命令名称或自述合规均不代替其他条件。最终列出实际共用读取、原命令路径及真实失败。此检查点统一既有要求,不新增用户必填参数、通用拦截器或业务JSON字段。
|
|
20
|
-
|
|
21
|
-
## 1. 对象明确后再规划
|
|
22
|
-
|
|
23
|
-
只读核当前项目与已采用规则、输入选择、真实资料和现有任务目标。用户可只输入 `/i3-sop plan`,或加一句主题;唯一材料与有效选择足够时直接承接,不要求再写长提示词或内部路径。多清单/多主题、动作正文矛盾、关键缺口或不同工作的未完计划,先说明实际选项、原因和建议并等待。无答复或取消零写入,不能按最大版本、目录顺序或模型推荐代选。
|
|
24
|
-
|
|
25
|
-
先区分清单路径交接和手动方式。显式给清单、项目实际采用记录或当前唯一且适用的清单均须真实读取;清单存在本身不改变标准流程或证明业务认可。损坏、不可读或未知格式先报告,不静默换源或退回手动掩盖。没有清单时可请用户明确实际AD及其配套或选择已有手动材料,不强制创建JSON、补BRD或重走前序。范围选择仅为本次会话,不写入永久偏好。
|
|
26
|
-
|
|
27
|
-
资源按本次明确材料→项目已采用自改副本→同宿主项目安装→同宿主可读全局定位。已选项目源失效就报告,不探读低优先级根来替代;不能确认自改合同已覆盖时完整读项目选定原件,不恢复发行副本。当前项目实际采用的CONSTRAINTS/ADR/技术规则照常有效。
|
|
28
|
-
|
|
29
|
-
## 2. 只读解析并实际读原文
|
|
30
|
-
|
|
31
|
-
先完成首批必读,再区分JSON解析和手动路径读取。两种方式均读所选根README、本索引stages.json、template-contracts.md、handoff-contract.md和本合同;生命周期或恢复有实质影响时读其适用约定。plan不加载BRD/PRD/AD/TestCase模板及其生成/审查提示词。项目规则及真实业务/技术依据必须实际回读。
|
|
32
|
-
|
|
33
|
-
复用[handoff.py](handoff.py)的 `resolve`,先核实际 `--help`;相对路径以明确的业务项目根解析,不以清单目录解析。以capabilityId+prdId识别本主题,明确组合逐主题解析;不以单个AD或JSON代替完整规格。工具返回路径不证明模型已读、配套正确或获得批准。
|
|
34
|
-
|
|
35
|
-
清单顶层仍仅schemaVersion、scope、selected。读取selected.technicalBaseline和本主题prd/ad/contracts/engineeringSkeleton及适用testCase/prototype;BRD按追溯需要读。不调用init/select/改选,不写JSON、审批、delivery、candidates、activeTopic或任务状态。
|
|
36
|
-
|
|
37
|
-
Python不可用时直接按用户明确的手动路径及准确引用读取,不安装环境或改JSON。手动输入可临时覆盖相同角色,但须说明与既有选择的差异,不持久化selected。现有resolve不做语义验证;身份、文件与正文版本、直接上游、共享权威与消费者影响由本次实际材料核对。
|
|
38
|
-
|
|
39
|
-
| 必要输入 | 如何核对 |
|
|
40
|
-
| --- | --- |
|
|
41
|
-
| 当前主题PRD+配套AD | 完整读取本次有效正文,核能力/主题、独立版本、AD直接上游和需求/AC;不猜高版本、不读另一主题替代 |
|
|
42
|
-
| 已采用技术规约与质量边界 | 真实文档或适用CONSTRAINTS/ADR;不是空模板。若已由AD/项目规则完整承载,不强制另建总规约 |
|
|
43
|
-
| 必要共享契约 | 当前接口、事件、数据责任、兼容/迁移和实际权威;跨主题只读所依赖定义,不全量加载所有AD或历史 |
|
|
44
|
-
| 工程采用/骨架来源 | 准确采用说明、来源版本、目录/模块责任和已有结构映射;规范不冒充可运行工程;初始化、调整或迁移按实际缺口排任务 |
|
|
45
|
-
| 相关代码及工程事实 | 实际完整读取相关源码及本项目依赖/构建配置,按真实技术栈定位,例如Node项目package.json;不能以AD/规范里的命令代替读取现有配置。核真实测试命令及示例,区分拟建与已有,不虚构已构建成功 |
|
|
46
|
-
| TestCase/原型 | 已形成且适用就核准确配套和范围。没有独立TestCase不统一阻断Plan,测试策略从AD/实际规范承接并排必要补齐;原型按需,无界面不强制补画 |
|
|
47
|
-
| 当前Plan/唯一任务目标 | 实际读取;不同工作未完先问,不覆盖或静默另起权威;同工作修订保留人工内容及已完成事实 |
|
|
48
|
-
|
|
49
|
-
逐项定位原SPEC六项:目标、完整可执行命令、项目结构、代码风格及示例、测试策略、Always/Ask first/Never工程边界。关键缺口先说明依赖影响;只有§2.1身份与直接上游已核一致后,非阻断缺口才可在明确范围内规划独立部分,不能用此条跨过身份停点或杜撰技术决定。长文按段覆盖并记录范围,摘要只导航,不以省上下文省略必要业务依据,不承诺固定耗时。
|
|
50
|
-
|
|
51
|
-
### 2.1 身份或直接上游冲突先停
|
|
52
|
-
|
|
53
|
-
对照本次准确PRD、AD正文的能力/主题标识、AD声明的直接上游路径与PRD版本,以及适用清单/手动选择。已声明内容互相矛盾时先报告冲突,不加载原规划、不创建或修改plan/todo,也不另存候选计划。即使AD正文功能一致、模型判断头部疑似笔误,身份仍不能由模型自行裁定;只给原文证据、影响、建议和可选操作,等待人工处理后重新核对,不修业务稿或JSON。选择了某个文件路径不等于确认了文件内部矛盾。
|
|
54
|
-
|
|
55
|
-
PRD与AD各自独立版本不必相同,例如PRD v0.0.1与AD v0.0.3明确引用该PRD v0.0.1是允许的;AD改引另一主题、错误路径或不同PRD版本则须先停。缺独立TestCase/原型仍按需处理,不扩大为统一规划前置。无冲突后的非阻断Q保留人工空间,不要求问题清零。
|
|
56
|
-
|
|
57
|
-
## 3. 实际复用原Plan
|
|
58
|
-
|
|
59
|
-
依据本宿主真实安装清单/命令目录定位原 `/i3-plan`(TOML宿主可能登记为planning),实际读当前命令义务;不要复制一份删减规则或写死开发工作区路径。加载原 [i3-planning-and-task-breakdown Skill](../../i3-planning-and-task-breakdown/SKILL.md)并取得本宿主正式机制的成功回执,再执行原方法。资源版本与安装位置须以实际文件核对。
|
|
60
|
-
|
|
61
|
-
有正式命令转交能力时记录真实转交;只有Skill工具时实际加载该Skill并履行原命令义务。两者如实区分,不能把Skill加载称为执行另一个slash命令。调用拒绝/失败或没有正式机制时停止,不裸跑生成计划;当前主会话阅读本说明不构成原规划已调用证据。
|
|
62
|
-
|
|
63
|
-
把上述实际引用、本次目标和必要澄清组织为内部规划任务,直接交原规划方法,不要求用户再复制提示词。原Plan负责只读理解、依赖图、纵向切片、AC/验证步骤、检查点和风险;本合同不重写其算法。计划文件的保存仍按原规则允许,不把“只读理解”误作不能写规划产物。
|
|
64
|
-
|
|
65
|
-
## 4. 原产物与停点
|
|
66
|
-
|
|
67
|
-
保持原默认 `tasks/plan.md` 与 `tasks/todo.md`,或项目已有明确且原规则允许的外部唯一任务目标。不得改原命令、另建SOP任务格式或覆盖不同工作的未完计划。计划内保留实际来源路径、正文版本、主题、FR/AC、必要共享依赖和验证依据;不能只留下一个可变JSON链接。
|
|
68
|
-
|
|
69
|
-
来源表列本次实际使用的PRD、AD、技术规范、共享契约、工程采用说明的完整项目相对路径和文档版本;明确项目外来源才用绝对路径。AD_v…、契约简称或JSON位置不代替准确来源。最终回读时逐项对照实际读取集合,缺引用先补齐原Plan再全文回读交审,不能只在会话报告补路径;不据此改写输入业务稿。
|
|
70
|
-
|
|
71
|
-
本动作只允许原规划产物,不改业务稿、JSON、采用记录、工程配置或代码。最后写入后完整回读实际plan与唯一任务目标,核覆盖和差量;来源在执行中变化须报告,不把旧任务套新设计。展示实际路径、未决项和范围,交人工审阅并停轮,不代批或自动Build。
|
|
72
|
-
|
|
73
|
-
使用者另行批准后调用原 `/i3-build` 或 `/i3-build auto`。有效规格路径、Git基线、完整计划明确认可、逐任务测试/构建/提交和风险停点均保留。未提交JSON、项目指引等仍可能触发原Git停点,不自动ignore、不擅自提交来规避;非默认位置与auto有冲突时如实说明。企业跨阶段auto属于3.1.0,不能由plan暗中启动。
|
|
@@ -1,109 +0,0 @@
|
|
|
1
|
-
{
|
|
2
|
-
"schemaVersion": 1,
|
|
3
|
-
"resourceId": "i3-enterprise-sop-prd",
|
|
4
|
-
"resourceVersion": "0.3.3",
|
|
5
|
-
"status": "local-resources-only-not-released",
|
|
6
|
-
"source": {
|
|
7
|
-
"path": "skills/i3-enterprise-sop/references/prd/templates/prd.md",
|
|
8
|
-
"templateVersion": "v0.0.4",
|
|
9
|
-
"sha256": "1c728d4865ae1ad3936a735d3543c21f4a06fd195f7f94c5ac721d560ca10aee",
|
|
10
|
-
"resourcePath": "templates/prd.md",
|
|
11
|
-
"distributionRendering": "Existing branding pipeline adds one standard i3:zh-guide block; remaining template bytes preserved."
|
|
12
|
-
},
|
|
13
|
-
"designEvidence": {
|
|
14
|
-
"path": "artifacts/verification/i1-full-handoff-20261017/REPORT.md",
|
|
15
|
-
"scope": "historical direct-Skill PRD verification; not included; PRD command needs separate evidence",
|
|
16
|
-
"sha256": "853be438ef3f41a0a0b2be9f0f307a2f947f3655939acb346b440feb996f3304",
|
|
17
|
-
"included": false
|
|
18
|
-
},
|
|
19
|
-
"prompts": {
|
|
20
|
-
"generate": "prompts/01-generate.md",
|
|
21
|
-
"review": "prompts/02-review.md",
|
|
22
|
-
"revise": "prompts/03-revise.md",
|
|
23
|
-
"recheck": "prompts/04-recheck.md"
|
|
24
|
-
},
|
|
25
|
-
"files": [
|
|
26
|
-
{
|
|
27
|
-
"path": "readme.md",
|
|
28
|
-
"sourceSha256": "60603eaa38487fa2eb6ead60378ba4f832830c2dafc4fee612dac3a0679a05e3",
|
|
29
|
-
"sha256": "c9667e22973d6c7b2a5e14d8fa6311fd99192a46404339e9cab5d044fc6038da",
|
|
30
|
-
"role": "project-owned-guidance"
|
|
31
|
-
},
|
|
32
|
-
{
|
|
33
|
-
"path": "prompts/01-generate.md",
|
|
34
|
-
"sourceSha256": "93ebe9f47214915f1043ca602c378b10a7f08be02462b5eb516032f4ed884a35",
|
|
35
|
-
"sha256": "5911edae8792a9a7e939f579de95ef237b577252e5bfae9a3ee5ebee7533da3a",
|
|
36
|
-
"role": "project-owned-guidance"
|
|
37
|
-
},
|
|
38
|
-
{
|
|
39
|
-
"path": "prompts/02-review.md",
|
|
40
|
-
"sourceSha256": "83b03378d7dec4a18217571e777b715a8aba02443ac453f3a5e118f114882f09",
|
|
41
|
-
"sha256": "03278975fb19b69d9023ec834c450322582d92672422f4b04e555cac8472b07e",
|
|
42
|
-
"role": "project-owned-guidance"
|
|
43
|
-
},
|
|
44
|
-
{
|
|
45
|
-
"path": "prompts/03-revise.md",
|
|
46
|
-
"sourceSha256": "f8dff8e817dad56552fd30e46d187c8515546b2f9c6e43a49c471f100711f6e5",
|
|
47
|
-
"sha256": "b2a1cf49d651e655fa28e81e5ce7771731d6a3f7c9ddd64a0c8e33b8c359732e",
|
|
48
|
-
"role": "project-owned-guidance"
|
|
49
|
-
},
|
|
50
|
-
{
|
|
51
|
-
"path": "prompts/04-recheck.md",
|
|
52
|
-
"sourceSha256": "33f6d6f20b2c08daaf6ec833fd775c3ad73fa70803c7e386f8f27395e46521ae",
|
|
53
|
-
"sha256": "bb457ebaadf55edd0aa913c4228b66786d2727c1b91d81abd4e8c3a2e5e22638",
|
|
54
|
-
"role": "project-owned-guidance"
|
|
55
|
-
},
|
|
56
|
-
{
|
|
57
|
-
"path": "template-contracts.md",
|
|
58
|
-
"sourceSha256": "2f822f9143284579977fe69dff1ce2d2854bb5107e737765ea3c27093d801a63",
|
|
59
|
-
"sha256": "30b64ac1b7f37b79ac6c1249d8e01cca53a5bd29b7442791a2a0af5cf917dca9",
|
|
60
|
-
"role": "project-owned-guidance"
|
|
61
|
-
},
|
|
62
|
-
{
|
|
63
|
-
"path": "templates/ad.md",
|
|
64
|
-
"sourceSha256": "f729203478a7bfb42451b053b8f4c7a0b1ce81ac666690e83176c5b02679b28e",
|
|
65
|
-
"sha256": "4cb36de42a3a27004f7dcc8f5669a6823307f0fe9e6e731d668373cb91a06d1a",
|
|
66
|
-
"role": "handoff-note-not-template"
|
|
67
|
-
},
|
|
68
|
-
{
|
|
69
|
-
"path": "templates/prd.md",
|
|
70
|
-
"sourceSha256": "1c728d4865ae1ad3936a735d3543c21f4a06fd195f7f94c5ac721d560ca10aee",
|
|
71
|
-
"sha256": "22f7b09d1b9914975d602e24f39ce7e63d945493f55a4654b6484a8569b73a8a",
|
|
72
|
-
"role": "exact-source-template-branded-guide-only"
|
|
73
|
-
}
|
|
74
|
-
],
|
|
75
|
-
"designSources": [
|
|
76
|
-
{
|
|
77
|
-
"path": "docs/sop-design/template-contracts.md",
|
|
78
|
-
"sha256": "b8aca73f3e8f70fc3b62df1aefdb8fb89097f7b896197e8d036948639e5e2609",
|
|
79
|
-
"included": false,
|
|
80
|
-
"role": "maintenance provenance only; not a readable bundled dependency",
|
|
81
|
-
"documentVersion": "v0.0.2",
|
|
82
|
-
"versionEvidence": "document header"
|
|
83
|
-
}
|
|
84
|
-
],
|
|
85
|
-
"projectDiscovery": {
|
|
86
|
-
"entryRelativeToReferences": "readme.md",
|
|
87
|
-
"codebuddyFragmentRelativeToReferences": "codebuddy-project-guide.md",
|
|
88
|
-
"activation": "explicit-enterprise-task-or-applicable-recorded-selection",
|
|
89
|
-
"ordinaryInstallEnablesEnterpriseWorkflow": false,
|
|
90
|
-
"resourceRoot": "actual-loaded-sop-skill/references"
|
|
91
|
-
},
|
|
92
|
-
"dependencies": [
|
|
93
|
-
{
|
|
94
|
-
"path": "../template-contracts.md",
|
|
95
|
-
"role": "shared-contract",
|
|
96
|
-
"resolutionBoundary": "selected-enterprise-sop-root"
|
|
97
|
-
},
|
|
98
|
-
{
|
|
99
|
-
"path": "../handoff-contract.md",
|
|
100
|
-
"role": "shared-handoff-contract",
|
|
101
|
-
"resolutionBoundary": "selected-enterprise-sop-root"
|
|
102
|
-
},
|
|
103
|
-
{
|
|
104
|
-
"path": "../lifecycle-contract.md",
|
|
105
|
-
"role": "shared-lifecycle-contract",
|
|
106
|
-
"resolutionBoundary": "selected-enterprise-sop-root"
|
|
107
|
-
}
|
|
108
|
-
]
|
|
109
|
-
}
|