pi-tsgw 0.0.16 → 0.0.18

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.
Files changed (32) hide show
  1. package/README.md +44 -12
  2. package/extensions/index.ts +2 -0
  3. package/extensions/mcp.ts +18 -6
  4. package/extensions/memory.ts +32 -0
  5. package/extensions/upload/local-file.ts +1 -1
  6. package/extensions/upload/protocol.ts +4 -4
  7. package/package.json +2 -2
  8. package/skills/{delegate-model-selection → tsgw-delegate-model-selection}/SKILL.md +1 -1
  9. package/skills/tsgw-git-commit/SKILL.md +65 -0
  10. package/skills/tsgw-git-commit/scripts/discover-repos.mjs +58 -0
  11. package/skills/tsgw-github/SKILL.md +85 -0
  12. package/skills/tsgw-mk-docs/SKILL.md +72 -0
  13. package/skills/tsgw-mk-docs/SOURCE.md +47 -0
  14. package/skills/tsgw-mk-docs/assets/000-todo.template.md +21 -0
  15. package/skills/tsgw-mk-docs/references/000-terminology.md +58 -0
  16. package/skills/tsgw-mk-docs/references/000-todo.md +106 -0
  17. package/skills/tsgw-mk-docs/references/a-series/checklist.md +20 -0
  18. package/skills/tsgw-mk-docs/references/a-series/modules.md +33 -0
  19. package/skills/tsgw-mk-docs/references/a-series/overview.md +24 -0
  20. package/skills/tsgw-mk-docs/references/b-series/checklist.md +20 -0
  21. package/skills/tsgw-mk-docs/references/b-series/modules.md +36 -0
  22. package/skills/tsgw-mk-docs/references/b-series/overview.md +24 -0
  23. package/skills/tsgw-mk-docs/references/c-series/checklist.md +20 -0
  24. package/skills/tsgw-mk-docs/references/c-series/modules.md +33 -0
  25. package/skills/tsgw-mk-docs/references/c-series/overview.md +23 -0
  26. package/skills/tsgw-mk-docs/references/design-doc-boundaries.md +146 -0
  27. package/skills/tsgw-programmer-go/SKILL.md +64 -0
  28. package/skills/tsgw-programmer-go/references/UPDATE_GUIDE.md +26 -0
  29. package/skills/tsgw-programmer-go/references/code_review_comments.md +50 -0
  30. package/skills/tsgw-programmer-go/references/effective_go.md +49 -0
  31. package/skills/tsgw-smemo/SKILL.md +179 -0
  32. package/skills/tsgw-smemo/references/blinko-guide.md +111 -0
package/README.md CHANGED
@@ -166,9 +166,22 @@ GPT 6.1 Sol、GPT 6 Astra,然后是受支持的 Grok 模型。没有候选模
166
166
  会话忙碌时按钮不可用。终端 CLI 以文本显示相同状态;请在那里使用斜杠命令。
167
167
  Pi Web 可能要等会话运行时启动后才显示扩展状态。
168
168
 
169
- ## 子代理编排技能
169
+ ## 随包技能
170
170
 
171
- 本包附带 [delegate-model-selection](skills/delegate-model-selection/SKILL.md),
171
+ | 技能 | 用途 |
172
+ | --- | --- |
173
+ | [tsgw-git-commit](skills/tsgw-git-commit/SKILL.md) | 暂存内容核验、分批提交与中文提交说明;包含支持 worktree 的只读仓库发现脚本。 |
174
+ | [tsgw-github](skills/tsgw-github/SKILL.md) | 使用 gh 查询与维护 issue、PR、CI,安全发布正文并核验 Actions 升级。 |
175
+ | [tsgw-mk-docs](skills/tsgw-mk-docs/SKILL.md) | 需求、设计、执行计划、术语和状态证据的文档治理,含参考清单与模板,不依赖审阅插件。 |
176
+ | [tsgw-programmer-go](skills/tsgw-programmer-go/SKILL.md) | Go 编码与审查;自产 JSON 使用 PascalCase、零值省略优先 omitzero,真实变更中同步迁移相关旧标签。 |
177
+ | [tsgw-smemo](skills/tsgw-smemo/SKILL.md) | Blinko 共享知识的检索、沉淀与维护,含原有维护授权和操作参考。 |
178
+
179
+ 技能从本地维护的工作流整理并适配 Pi,按本项目 MIT 许可证提供;不包含第三方 gitmoji 数据集。
180
+ 项目规则和用户授权优先,不安装 Git hook,不自动推送或发布。已有同类用户级技能时,建议择一启用,避免重复指导。
181
+
182
+ ### 子代理编排与模型选型
183
+
184
+ 本包附带 [tsgw-delegate-model-selection](skills/tsgw-delegate-model-selection/SKILL.md),
172
185
  鼓励适合的任务通过后台子代理执行,并提供模型/思考级别指导,包括独立的 Kimi + Astra 审查。
173
186
  任务拆分、并行、验证和升级仍由代理自行决定。
174
187
 
@@ -177,23 +190,42 @@ Pi Web 可能要等会话运行时启动后才显示扩展状态。
177
190
  GLM 指导使用 5.3,并以 Flash 和 FlashX 为备选。思考级别使用 Pi 名称:M3 推荐 `high`,
178
191
  与其其他非 off 级别一样,映射为 adaptive。
179
192
 
180
- 安装并执行 `/reload` 后,Pi 会通过包清单发现该技能,除非宿主/包设置禁用或过滤了技能。
181
- 仅加载 `extensions/index.ts` 不会加载包内技能。需要宿主提供支持模型选择的子代理工具,
182
- 且有可用的 `tsgw` 模型;本包不提供该工具,也不改变调度设置、用户规则或权限。
193
+ 安装并执行 `/reload` 后,Pi 会通过包清单发现随包技能,除非宿主/包设置禁用或过滤了技能。
194
+ 可以使用 `/skill:tsgw-git-commit` 等命令显式加载;仅加载 `extensions/index.ts` 不会加载包内技能。
195
+ 包设置中的 `skills: []` 可禁用全部技能,`skills: ["skills/tsgw-git-commit"]` 可仅加载指定技能,
196
+ 或用 `skills: ["!skills/tsgw-git-commit/**"]` 排除该技能;由宿主处理,不是 `tsgw` 配置项。
197
+
198
+ 只有模型选型技能需要宿主提供支持模型选择的子代理工具及可用的 `tsgw` 模型;通用开发技能不绑定模型 provider。
199
+ 本包不提供子代理工具,也不改变调度设置、用户规则文件或宿主权限。
200
+
201
+ ### 记忆规则注入
202
+
203
+ 插件在 `before_agent_start` 中注入原用户规则中的记忆体系与既有条目维护授权,
204
+ 不绑定当前模型 provider,不新增配置,不改写用户规则文件。
205
+ 详细流程保留在 `tsgw-smemo` 技能及其参考资料中;`ctx_memory` 仍称为“系统记忆”,
206
+ smemo/Blinko 仍称为“记忆系统”。技能迁移不操作 Blinko 数据或改变宿主认证与权限。
207
+ 从本地 `smemo` 迁入时,确认新版本插件与随包技能加载生效后,再移除原技能和用户规则中的重复内容。
183
208
 
184
209
  ## 默认 MCP 注册
185
210
 
186
- 插件每次加载时都会注册 `ts_oht`,端点为 `https://xn--oht.cc/mcp`,
187
- 暴露方式为 `codemode`。使用此默认配置无需任何 MCP 配置。
188
- 用户级设置中可选的 `tsgw.mcpUrl` 会改变插件使用的端点;它独立于 `tsgw.baseUrl`,
189
- 且仅在初始化时读取一次。显式 URL 无效时,会安全地发出警告并跳过注册,
190
- 而不是静默连接默认端点。不支持 `registerMcpServer` 的旧宿主会跳过注册。
211
+ 插件每次加载时都会向宿主登记以下会话默认值,暴露方式均为 `codemode`:
212
+
213
+ | 服务器名称 | 默认端点 |
214
+ | --- | --- |
215
+ | `ts_oht` | `https://xn--oht.cc/mcp` |
216
+ | `ts_tool` | `https://mcp.tossp.com/mm/ts/mcp` |
217
+
218
+ 使用这些默认值无需手工配置 MCP。用户级设置中可选的 `tsgw.mcpUrl` 仅覆盖 `ts_oht`,
219
+ 独立于 `tsgw.baseUrl`,且仅在初始化时读取一次;`ts_tool` 的覆盖交给宿主同名文件配置,
220
+ 没有额外的插件配置项。显式 `mcpUrl` 无效时,安全警告并仅跳过 `ts_oht`,
221
+ 不静默回退,也不影响 `ts_tool`。单个登记失败不阻断另一服务或模型提供方;
222
+ 不支持 `registerMcpServer` 的旧宿主会跳过两者注册。
191
223
 
192
- Pi 管理连接、OAuth 登录和凭据。需要登录时,在会话内使用 `/mcp login ts_oht`。
224
+ Pi 管理连接、OAuth 登录和凭据。需要登录时,在会话内对相应服务使用 `/mcp login ts_oht` 或 `/mcp login ts_tool`。
193
225
  插件不读写 `mcp.json` 或 `mcp-auth.json`,也不携带凭据。
194
226
  保持相同的服务器名称和完全一致的 URL,才能复用宿主现有的 OAuth 作用域。
195
227
 
196
- 有效的全局/项目 `mcp.json` 中同名的 `ts_oht` 优先于插件注册,包括 `enabled: false`;
228
+ 有效的全局/项目 `mcp.json` 中同名的 `ts_oht`、`ts_tool` 分别优先于插件注册,包括 `enabled: false`;
197
229
  插件不会创建第二条连接,也不会绕过该选择。要覆盖 URL、暴露方式、超时、认证或启用状态,
198
230
  请在文件中使用完整的同名配置。对插件提供的服务器所做的更改仅作用于当前会话,不会保存。
199
231
  Shell 中的 `pi mcp` 命令不加载插件,无法看到仅由此注册提供的服务器。
@@ -30,6 +30,7 @@ import {
30
30
  import type { ThinkingLevel, WebSearchMode } from "./models/_tools.ts";
31
31
  import { registerUploadTool } from "./upload/index.ts";
32
32
  import { registerTsgwMcp } from "./mcp.ts";
33
+ import { registerMemoryRules } from "./memory.ts";
33
34
 
34
35
  /**
35
36
  * 在生命周期上下文仍有效时,复制供应商钩子所需的数据。
@@ -199,6 +200,7 @@ async function resolveEffectiveModels(
199
200
 
200
201
  export default async function registerTsgw(pi: ExtensionAPI): Promise<void> {
201
202
  registerUploadTool(pi);
203
+ registerMemoryRules(pi);
202
204
  const settings = readTsgwSettings();
203
205
  registerTsgwMcp(pi, settings.mcpUrl);
204
206
  const root = rootForRuntime(settings.baseUrl);
package/extensions/mcp.ts CHANGED
@@ -2,25 +2,37 @@ import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
2
2
 
3
3
  export const TS_OHT_NAME = "ts_oht";
4
4
  export const TS_OHT_URL = "https://xn--oht.cc/mcp";
5
+ export const TS_TOOL_NAME = "ts_tool";
6
+ export const TS_TOOL_URL = "https://mcp.tossp.com/mm/ts/mcp";
5
7
 
6
8
  /** 仅设置会话默认值;文件覆盖、连接与 OAuth 由 Pi 管理。 */
7
9
  export function registerTsgwMcp(pi: ExtensionAPI, configuredUrl?: unknown): void {
10
+ if (typeof pi.registerMcpServer !== "function") {
11
+ console.error("TSGW:当前 Pi 宿主无法注册 MCP 服务器;已跳过 ts_oht、ts_tool 注册。");
12
+ return;
13
+ }
8
14
  const value = configuredUrl === undefined ? TS_OHT_URL : configuredUrl;
15
+ let ohtUrl: string | undefined;
9
16
  try {
10
17
  if (typeof value !== "string" || value.trim() !== value) throw new Error();
11
18
  const url = new URL(value);
12
19
  if (!["https:", "http:"].includes(url.protocol) || url.username || url.password || url.hash)
13
20
  throw new Error();
21
+ ohtUrl = value;
14
22
  } catch {
15
23
  // 显式配置无效时,不得改用其他默认地址连接。
16
24
  // 常规日志中绝不包含 URL 或解析器错误。
17
25
  console.error("TSGW:mcpUrl 无效;已跳过 ts_oht 注册。");
18
- return;
19
- }
20
- if (typeof pi.registerMcpServer !== "function") {
21
- console.error("TSGW:当前 Pi 宿主无法注册 MCP 服务器;已跳过 ts_oht 注册。");
22
- return;
23
26
  }
24
27
  // 保留精确 URL,因为 Pi 将 OAuth 绑定到服务器名称与 URL 的组合。
25
- pi.registerMcpServer(TS_OHT_NAME, { url: value as string, exposure: "codemode" });
28
+ // 独立登记:无效的 ts_oht 配置或单个登记失败不得阻止另一个服务和 provider。
29
+ for (const [name, url] of [[TS_OHT_NAME, ohtUrl], [TS_TOOL_NAME, TS_TOOL_URL]] as const) {
30
+ if (url === undefined) continue;
31
+ try {
32
+ pi.registerMcpServer(name, { url, exposure: "codemode" });
33
+ } catch {
34
+ // 不输出可能包含配置或凭据的宿主异常。
35
+ console.error(`TSGW:宿主无法登记 ${name};已跳过,请检查 Pi MCP 支持或同名扩展。`);
36
+ }
37
+ }
26
38
  }
@@ -0,0 +1,32 @@
1
+ import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
2
+
3
+ /** 从用户规则迁入的记忆体系与既有维护授权。 */
4
+ export const MEMORY_RULES = `## 记忆体系
5
+
6
+ \`ctx_memory\` 称为“系统记忆”,smemo/Blinko 称为“记忆系统”,两者不混称。
7
+
8
+ | 入口 | 分工 |
9
+ | --- | --- |
10
+ | 项目多层级 \`AGENTS.md\` | 项目指引、长期专有规则、方法和资料入口 |
11
+ | \`ctx_memory\` | 记录和更新跨会话需要延续的项目知识 |
12
+ | \`ctx_search\`、\`ctx_expand\`、\`ctx_reduce\` | 检索历史、恢复原始内容、释放已用完的上下文 |
13
+ | \`ctx_note\`、\`todowrite\` | 分别管理后续事项和当前任务 |
14
+ | \`skill:tsgw-smemo\` → Blinko | 维护跨设备共享知识,职责与操作按技能执行 |
15
+
16
+ - ctx 在同设备的 PiWeb/OC 间互通,项目与会话仍有作用范围,不跨设备共享;Blinko 由各设备 PiWeb/OC 共用。个人倾向由 Magic Context 的用户记忆机制(\`user-profile\`)维护,不另存为项目记忆或写入 smemo。
17
+ - 先利用已注入规则和当前上下文,再按需通过 ctx 检索、展开历史;需要共享知识或外部调研时使用 smemo,不要求每次遍历所有入口。
18
+ - 新结论按职责及时更新对应载体:工作延续用 ctx,长期项目规则归 \`AGENTS.md\`,共享知识按 smemo 技能沉淀;用摘要和引用关联,不重复维护完整正文。
19
+ - 工具细则以实时提示和技能为准;规则与技能在获准范围内跨端统一维护,单端修改不代表已经同步。
20
+
21
+ - smemo 条目内容维护(含永久删除)的持续授权见 \`skill:tsgw-smemo\`,不由此放宽文件、Git、服务、凭据或权限操作边界。`;
22
+
23
+ export function registerMemoryRules(pi: ExtensionAPI): void {
24
+ pi.on("before_agent_start", (event) => {
25
+ if (event.systemPromptOptions) {
26
+ event.systemPromptOptions.sections.tsgw_memory = MEMORY_RULES;
27
+ return;
28
+ }
29
+ // 保留已声明支持的旧宿主提示词接口。
30
+ return { systemPrompt: `${event.systemPrompt}\n\n${MEMORY_RULES}` };
31
+ });
32
+ }
@@ -47,7 +47,7 @@ export async function openLocalFile(path: string, cwd: string, contentType?: str
47
47
  if (Buffer.byteLength(filename) > 255 || filename.trim() !== filename || /[\u0000-\u001f\u007f-\u009f\\%?#:<>"|*]/.test(filename))
48
48
  throw new UploadError("invalid-filename", "上传服务不支持此文件名。");
49
49
  const mime = contentType ?? MIME[extname(filename).toLowerCase()] ?? "application/octet-stream";
50
- if (mime.length > 127 || !CONTENT_TYPE_PATTERN.test(mime))
50
+ if (mime.length > 127 || CONTENT_TYPE_PATTERN.exec(mime)?.[0] !== mime)
51
51
  throw new UploadError("invalid-content-type", "contentType 必须是不带参数的 MIME 类型。");
52
52
  const metadata: FileMetadata = { filename, contentType: mime.toLowerCase(), size,
53
53
  mtimeMs: Number(initial.mtimeNs) / 1e6, ctimeMs: Number(initial.ctimeNs) / 1e6 };
@@ -4,9 +4,9 @@ export const SINGLE_LIMIT = 32 * 1024 ** 2;
4
4
  export const MAX_BYTES = 5 * 1024 ** 4;
5
5
  export const UPLOAD_TOOL = "mcp__ts_oht__upload_file";
6
6
  export const URL_TOOL = "mcp__ts_oht__get_file_url";
7
- // 绝对结尾断言:JavaScript 单独使用 `$` 也会接受末尾换行。
8
- export const CONTENT_TYPE_PATTERN = /^[A-Za-z0-9!#$&^_.+-]+\/[A-Za-z0-9!#$&^_.+-]+$(?![\s\S])/;
9
- export const RESUME_PATTERN = /^[A-Za-z0-9_-]+$(?![\s\S])/;
7
+ // 对外 schema 不使用 lookaround;执行层额外比较完整匹配,拒绝 JavaScript `$` 可接受的末尾换行。
8
+ export const CONTENT_TYPE_PATTERN = /^[A-Za-z0-9!#$&^_.+-]+\/[A-Za-z0-9!#$&^_.+-]+$/;
9
+ export const RESUME_PATTERN = /^[A-Za-z0-9_-]+$/;
10
10
 
11
11
  export interface FileMetadata {
12
12
  filename: string;
@@ -162,7 +162,7 @@ export function encodeReceipt(receipt: Receipt): string {
162
162
  }
163
163
  export function decodeReceipt(token: string): Receipt {
164
164
  try {
165
- if (!token || token.length > 8192 || !RESUME_PATTERN.test(token)) invalidResponse();
165
+ if (!token || token.length > 8192 || RESUME_PATTERN.exec(token)?.[0] !== token) invalidResponse();
166
166
  const data = object(JSON.parse(Buffer.from(token, "base64url").toString("utf8")));
167
167
  const meta = object(data.metadata);
168
168
  if (data.version !== 1 || !["single", "multipart"].includes(String(data.mode)) ||
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "pi-tsgw",
3
- "version": "0.0.16",
3
+ "version": "0.0.18",
4
4
  "description": "面向 TOSSP AIH gateway 的 Pi 扩展:按厂商维护模型目录与思考策略,支持 openai-completions、openai-responses、anthropic-messages 和 google-generative-ai 协议。",
5
5
  "type": "module",
6
6
  "keywords": [
@@ -24,7 +24,7 @@
24
24
  ]
25
25
  },
26
26
  "scripts": {
27
- "test": "tsc -p tsconfig.test.json && node dist/extensions/index.test.js && node dist/extensions/status.test.js && node dist/extensions/search.test.js && node dist/extensions/search-proxy.test.js && node dist/extensions/search-host-integration.test.js && node dist/extensions/status-integration.test.js && node dist/extensions/models/gateway-catalog-metadata.test.js && node dist/extensions/models/operations.test.js && node dist/extensions/models/catalog.test.js && node dist/extensions/models/web-search.test.js && node dist/extensions/models/gateway-catalog.test.js && node dist/extensions/models/gateway-catalog-isolation.test.js && node dist/extensions/models/vendor-strategies.test.js && node dist/extensions/host-integration.test.js && node dist/extensions/mcp.test.js && node dist/extensions/mcp-host-integration.test.js && node dist/extensions/skills.test.js && node dist/extensions/upload/protocol.test.js && node dist/extensions/upload/schema.test.js && node dist/extensions/upload/uploader.test.js && node dist/extensions/upload/transport.test.js && node dist/extensions/upload/host-integration.test.js && node dist/extensions/upload/readiness-host.test.js",
27
+ "test": "tsc -p tsconfig.test.json && node dist/extensions/index.test.js && node dist/extensions/memory.test.js && node dist/extensions/status.test.js && node dist/extensions/search.test.js && node dist/extensions/search-proxy.test.js && node dist/extensions/search-host-integration.test.js && node dist/extensions/status-integration.test.js && node dist/extensions/models/gateway-catalog-metadata.test.js && node dist/extensions/models/operations.test.js && node dist/extensions/models/catalog.test.js && node dist/extensions/models/web-search.test.js && node dist/extensions/models/gateway-catalog.test.js && node dist/extensions/models/gateway-catalog-isolation.test.js && node dist/extensions/models/vendor-strategies.test.js && node dist/extensions/host-integration.test.js && node dist/extensions/mcp.test.js && node dist/extensions/mcp-host-integration.test.js && node dist/extensions/skills.test.js && node dist/extensions/skill-resources.test.js && node dist/extensions/upload/protocol.test.js && node dist/extensions/upload/schema.test.js && node dist/extensions/upload/uploader.test.js && node dist/extensions/upload/transport.test.js && node dist/extensions/upload/host-integration.test.js && node dist/extensions/upload/readiness-host.test.js",
28
28
  "test:upload:live": "tsc -p tsconfig.test.json && node dist/extensions/upload/live.test.js"
29
29
  },
30
30
  "peerDependencies": {
@@ -1,5 +1,5 @@
1
1
  ---
2
- name: delegate-model-selection
2
+ name: tsgw-delegate-model-selection
3
3
  description: 当本技能存在时,应更倾向于把适合委派的任务编排为子代理背景执行。本技能定义编排中的模型与思考深度选择,应尽量遵循;具体任务拆分、并行方式与升级策略由模型结合现场自行判断。
4
4
  license: MIT
5
5
  compatibility: 需要宿主提供子代理工具及可用的 tsgw 模型。
@@ -0,0 +1,65 @@
1
+ ---
2
+ name: tsgw-git-commit
3
+ description: 核验 Git 暂存内容、按功能拆分提交并生成中文提交说明。用户要求 commit、提交代码或跨仓库分批提交时使用;遵循项目提交规范及明确授权范围。
4
+ license: MIT
5
+ compatibility: 需要 Git;附带的只读仓库发现脚本需要 Node.js。
6
+ ---
7
+
8
+ # Git 提交
9
+
10
+ 先确认目标仓库与授权范围,再以暂存区作为提交内容的唯一依据。本技能由本地维护的提交工作流整理为 Pi 版,不依赖 OpenCode 专属工具,也不安装 Git hook。
11
+
12
+ ## 1. 定位仓库
13
+
14
+ - 用户已明确仓库或当前上下文唯一时,直接使用该仓库,不重复询问。
15
+ - 用 `git -C <repo> rev-parse --show-toplevel` 确认真实根目录,并检查分支、工作区及已有暂存内容。
16
+ - 多仓库任务需要盘点时,使用随附只读脚本;它检查目标目录及直接子目录,支持 `.git` 目录和 worktree 的 `.git` 文件,不递归扫描整台主机:
17
+
18
+ ```bash
19
+ node <skill-dir>/scripts/discover-repos.mjs --json <project-root>
20
+ ```
21
+
22
+ `<skill-dir>` 替换为本技能实际目录。脚本仅报告有暂存变更的仓库;空列表不代表没有未暂存修改,失败也不应当作空列表。
23
+
24
+ - 多个候选无法判定、用户指定的仓库不存在或提交范围不明确时,集中询问必要问题。使用当前宿主实际提供的交互入口;不假设存在 `questions`。
25
+
26
+ ## 2. 核验内容与划分批次
27
+
28
+ ```bash
29
+ git -C <repo> status --short
30
+ git -C <repo> diff
31
+ git -C <repo> diff --cached --name-only
32
+ git -C <repo> diff --cached --stat
33
+ git -C <repo> diff --cached
34
+ git -C <repo> log -5 --oneline
35
+ ```
36
+
37
+ - `git status` 只给工作区概况,不能替代完整 `git diff --cached`。
38
+ - 已有暂存内容默认保留,不把其他协作者的变更混入或移出。
39
+ - 用户已授权提交本轮实现、但文件尚未暂存时,可以仅 `git add -- <明确路径>` 暂存本轮相关文件;没有暂存内容且没有暂存授权时,报告现状并停止。
40
+ - 按独立功能、修复或文档范围分批提交;已明确的分批授权无需逐批重复确认。
41
+ - 若涉及他人暂存内容、拆分不明确或同一文件中混有无关修改,先说明方案并确认;不盲目全量 `git add .`,不默认交互式拆分。
42
+ - 每次调整暂存区后,重新读取该批次的 `git diff --cached` 并核对文件与差异。
43
+
44
+ ## 3. 验证与提交说明
45
+
46
+ - 运行与改动范围相称的测试、编译或静态检查,再执行 `git diff --cached --check`。
47
+ - 检查失败先修复或明确报告阻塞,不用跳过检查、禁用 hook 或降低验证标准制造成功。
48
+ - 优先遵循项目 `AGENTS.md`、提交校验器与既有格式。没有项目规范时采用 `type(scope): 中文说明`;scope 可省略,正文用中文解释原因与边界。
49
+ - 常用 type 为 `feat`、`fix`、`refactor`、`docs`、`test`、`build`、`ci`、`chore`、`perf`、`style`、`revert`。不要把这份建议覆盖到项目既有校验规则。
50
+ - emoji 可按项目习惯使用,不强制引入 gitmoji 数据集或一套新的校验器。
51
+ - 仅描述本批次实际改动。有关 issue、PR 或工作项使用平台可识别的引用;不要伪造未推送提交链接。
52
+
53
+ ## 4. 提交与结果核对
54
+
55
+ 简单说明可用 `git -C <repo> commit -m 'type(scope): 中文说明'`;多行正文先通过宿主文件写入工具保存到安全的临时文件,再使用 `git -C <repo> commit -F <message-file>`,避免 Shell 插值。
56
+
57
+ - 用户已明确授权且范围清楚时,验证后直接提交;只有用户要求审阅或范围实质变化时才再次确认。
58
+ - 不单独执行、安装或绕过 Git hook;普通 `git commit` 正常触发仓库已有 hook,失败时读取原因并报告。
59
+ - 提交后核验 `git log -1 --oneline`、`git status --short` 和剩余 diff,确认本批次没有遗漏或混入其他改动。
60
+ - 多仓库分别验证、分别提交;发生失败时说明哪些仓库已成功、哪些尚未提交,不声称跨仓库原子成功。
61
+ - 汇报提交 hash、主题、验证结果及未提交/未推送状态。推送、打 tag、发布只有取得对应授权后才执行。
62
+
63
+ ## 安全边界
64
+
65
+ 不把提交授权解释为删除数据、覆盖工作区、改写历史或发布授权。不执行 `git reset --hard`、`git clean -fd`、强制推送或未经授权的 amend。不要在提交准备中顺手修改无关源码、凭据、远端配置或用户配置。
@@ -0,0 +1,58 @@
1
+ #!/usr/bin/env node
2
+ // 只读检查目标及直接子目录,不读取凭据、不修改工作区或暂存区。
3
+ import { spawnSync } from "node:child_process";
4
+ import { existsSync, readdirSync, realpathSync, statSync } from "node:fs";
5
+ import { basename, join, resolve } from "node:path";
6
+ import { fileURLToPath } from "node:url";
7
+
8
+ function git(path, args, allowFailure = false) {
9
+ const result = spawnSync("git", ["-C", path, ...args], {
10
+ encoding: "utf8", maxBuffer: 8 * 1024 * 1024, stdio: ["ignore", "pipe", "pipe"],
11
+ });
12
+ if (result.error || result.signal || result.status !== 0) {
13
+ if (allowFailure && !result.error && !result.signal && result.status === 1) return null;
14
+ throw new Error(`Git 检查失败:${path}(${args[0]})`);
15
+ }
16
+ return result.stdout;
17
+ }
18
+
19
+ export function discoverRepositories(projectRoot) {
20
+ const root = realpathSync(resolve(projectRoot));
21
+ if (!statSync(root).isDirectory()) throw new Error("目标必须是目录。");
22
+ const candidates = [root, ...readdirSync(root, { withFileTypes: true })
23
+ .filter(entry => entry.isDirectory() && entry.name !== ".git")
24
+ .map(entry => join(root, entry.name))];
25
+ const repositories = [];
26
+ const seen = new Set();
27
+ for (const candidate of candidates) {
28
+ // 普通仓库是目录,worktree 和 submodule 通常是文件;由 Git 核验真实根目录。
29
+ if (!existsSync(join(candidate, ".git"))) continue;
30
+ const path = realpathSync(git(candidate, ["rev-parse", "--show-toplevel"]).trim());
31
+ if (seen.has(path)) continue;
32
+ seen.add(path);
33
+ const staged = git(path, ["diff", "--cached", "--name-only", "-z"]);
34
+ const stagedFiles = staged.split("\0").filter(Boolean).length;
35
+ if (stagedFiles === 0) continue;
36
+ const branch = git(path, ["symbolic-ref", "--quiet", "--short", "HEAD"], true)?.trim()
37
+ ?? `detached:${git(path, ["rev-parse", "--short", "HEAD"]).trim()}`;
38
+ repositories.push({ name: basename(path), path, stagedFiles, branch });
39
+ }
40
+ return { repositories };
41
+ }
42
+
43
+ if (process.argv[1] && resolve(process.argv[1]) === fileURLToPath(import.meta.url)) {
44
+ const args = process.argv.slice(2);
45
+ const paths = args.filter(arg => arg !== "--json");
46
+ try {
47
+ if (paths.length !== 1 || paths[0].startsWith("--"))
48
+ throw new Error("用法:node discover-repos.mjs [--json] <project-root>");
49
+ const result = discoverRepositories(paths[0]);
50
+ if (args.includes("--json")) console.log(JSON.stringify(result, null, 2));
51
+ else if (result.repositories.length === 0) console.log("未发现有暂存变更的仓库。");
52
+ else for (const repo of result.repositories)
53
+ console.log(`${repo.name}:${repo.path}(${repo.branch},${repo.stagedFiles} 个暂存文件)`);
54
+ } catch (error) {
55
+ console.error(error instanceof Error ? error.message : "仓库检查失败。");
56
+ process.exitCode = 1;
57
+ }
58
+ }
@@ -0,0 +1,85 @@
1
+ ---
2
+ name: tsgw-github
3
+ description: "优先使用 gh CLI 处理 GitHub issue、PR、评论、CI 与失败日志、Contents API 读取,以及 Actions 依赖升级核验;适用于需要精确仓库上下文和安全发布 Markdown 正文的任务。"
4
+ license: MIT
5
+ ---
6
+
7
+ # GitHub 工作流(Pi)
8
+
9
+ 本技能经用户授权,将其本地维护的工作流自主重新组织为精简指导,以 MIT 许可提供;不复制第三方长篇文档。
10
+
11
+ ## 先确定上下文与权限
12
+
13
+ - 优先通过 Pi 的 `bash` 执行 `gh`;用 `read` 阅读本地文件,用 `write` / `edit` 准备或修改内容。不依赖特定问答工具、私人配置路径或额外插件。
14
+ - 从任务、项目约定及 Git remote 核对目标主机、`owner/repo`、issue/PR 编号和分支;不要混淆 fork 与上游、PR 源分支与目标分支。同名编号不能跨仓库复用。
15
+ - 示例中的 `OWNER/REPO`、编号、路径与 ref 均为占位值。调用时显式传 `--repo OWNER/REPO` 或完整对象 URL;`gh api` 使用精确的 `repos/OWNER/REPO/...`,非 github.com 时还须明确目标主机(API 用 `--hostname`)。不要只依赖当前目录的隐式仓库。
16
+ - 遵守当前任务的文件范围、联网与副作用限制。已明确授权的范围内直接执行,不额外要求逐步回复 `yes/no/edit`;范围或目标不清楚时在对话中询问。未经授权的发布、合并、删除、强推、远程工作流触发或重跑等动作应先确认;已有授权覆盖这些动作时无需重复确认。
17
+ - `gh` 未安装或认证不可用时报告阻塞,不擅自安装、登录、索取令牌或读取私人凭据。禁止联网时只做本地分析,明确远程状态未核验。
18
+
19
+ ## 查询 issue、PR、CI 与日志
20
+
21
+ 先读现状再决定变更;优先 `--json` 与 `--jq` 获取需要的字段,CLI 不足时再用 `gh api`。列表结果可能分页,完整枚举时使用分页或说明截断。
22
+
23
+ ```bash
24
+ gh issue list --repo OWNER/REPO --state open --limit 20 --json number,title,url
25
+ gh issue view 55 --repo OWNER/REPO --json title,body,state,url
26
+ gh pr view 55 --repo OWNER/REPO --json title,body,state,baseRefName,headRefName,headRefOid,url
27
+ gh pr checks 55 --repo OWNER/REPO
28
+ gh run list --repo OWNER/REPO --limit 10
29
+ gh run view RUN_ID --repo OWNER/REPO
30
+ gh run view RUN_ID --repo OWNER/REPO --log-failed
31
+ gh api repos/OWNER/REPO/pulls/55 --jq '{title, state, user: .user.login}'
32
+ ```
33
+
34
+ 将 CI 结果绑定到正确的 run、分支及 commit;区分排队、运行中、跳过、取消与失败。检查失败 job/step 日志,必要时读取完整 `--log`,不把“没有失败日志”当作成功。报告根因证据时避免泄露日志中的凭据或敏感数据,不为验证推断而擅自重跑工作流。
35
+
36
+ ## 多行正文与发布后回读
37
+
38
+ issue、PR 及评论的创建和编辑,复杂或多行 Markdown 一律先写入临时 `.md` 文件,再用 `--body-file`,避免 `--body "..."` 的转义和 Shell 插值。用 Pi `write` 或带引号定界符的 heredoc 写入原文;临时文件也须位于当前任务允许写入的位置。编辑前读取原正文,保留非目标内容。
39
+
40
+ 以下均为已获相应发布授权时的命令示例,并非自动执行清单:
41
+
42
+ ```bash
43
+ gh issue create --repo OWNER/REPO --title '标题' --body-file BODY.md
44
+ gh issue edit 55 --repo OWNER/REPO --body-file BODY.md
45
+ gh issue comment 55 --repo OWNER/REPO --body-file BODY.md
46
+ gh pr create --repo OWNER/REPO --base BASE --head HEAD --title '标题' --body-file BODY.md
47
+ gh pr edit 55 --repo OWNER/REPO --body-file BODY.md
48
+ ```
49
+
50
+ 发布或编辑后回读实际对象,核对正文、目标及 URL,而非仅以命令退出码判定成功:
51
+
52
+ - issue/PR 正文:用 `gh issue view` / `gh pr view`,指定 `--json body,url`。
53
+ - 评论:根据返回 URL 定位评论 ID,再读取 `gh api repos/OWNER/REPO/issues/comments/COMMENT_ID`;PR review 评论则使用对应的 `pulls/comments/COMMENT_ID` 端点。父 issue/PR 的 `body` 不能验证评论。
54
+ - 正文损坏时,在授权内用正文文件修复目标对象;请求结果不明时先查询,避免重复发布。说明处理的是正文转义 / Shell 插值问题。
55
+
56
+ ## Contents API:路径、ref 与编码
57
+
58
+ 必要时先列父目录确认路径;分支影响结果时显式指定 ref。分别编码路径中的特殊字符和 ref 参数值,保留路径层级的 `/`;例如空格 `%20`、`(` 为 `%28`、`)` 为 `%29`,ref 内的 `/` 可编码为 `%2F`。将整个端点置于 Shell 引号中。
59
+
60
+ ```bash
61
+ gh api 'repos/OWNER/REPO/contents/docs?ref=main' --jq '.[].path'
62
+ gh api 'repos/OWNER/REPO/contents/docs/Guide%20%28CI%29.md?ref=feature%2Fci'
63
+ ```
64
+
65
+ 文件响应通常包含编码后的 `content`,目录响应则为列表;按响应类型和 `encoding` 处理,不能把元数据当正文。遇到 404 先排查仓库、路径大小写、ref 与编码,再核查访问权限,不直接认定为认证失败。汇报时说明是否处理了路径 / ref / 编码不匹配。
66
+
67
+ ## Actions 升级:先核验,再做最小变更
68
+
69
+ 1. 阅读项目策略并枚举全部工作流中直接的外部 `uses:`,包括 step Action 与 job 级可复用工作流;本地 `./...` 与间接依赖不混入外部 Action 升级清单,`docker://...` 单独按镜像规则处理。不为追踪版本添加未使用的 Action。
70
+ 2. 在允许联网时,查询各引用的官方仓库、非草稿且非预发布的稳定 release 及 tags,阅读发布说明、迁移文档与目标版本的 Action 元数据。不要仅凭 tag 名或“latest”断言兼容。
71
+
72
+ ```bash
73
+ gh release list --repo OWNER/ACTION --exclude-drafts --exclude-pre-releases --limit 10
74
+ gh api repos/OWNER/ACTION/tags --paginate --jq '.[].name'
75
+ gh release view TAG --repo OWNER/ACTION
76
+ ```
77
+
78
+ 3. 项目策略优先;无明确变更要求时保留既有 pinning(SHA、精确版本或主版本引用),不顺手统一。只有具体升级、安全或兼容需求并核验后才修改;SHA 应核对其与官方目标版本的对应关系。若项目沿用 `@vN`,可说明其可读性与跟随同主版本更新的取舍;主版本浮动引用不是所有项目的安全最佳实践。
79
+ 4. 主版本升级前比较输入、输出、权限、最低 Runner 版本、托管或自托管 Runner 兼容性及 Action 自身的 Node 运行时。项目 `setup-node` 的版本与运行 Action 的 Node 版本不是一回事;可复用工作流还要核对输入、secrets 与调用契约。
80
+ 5. 修改后重新静态枚举 `uses:`,逐项核对预期 ref;除迁移确有必要的变更外,保留 `with`、jobs、permissions、secrets 和触发行为。运行已有的本地验证,不擅自安装验证工具;远程 CI、发布验证仅在授权内执行。
81
+ 6. 汇报引用前后值、官方依据、兼容性检查及未验证项。离线时不宣称“最新”或“已通过远程 CI”。
82
+
83
+ ## 完成检查
84
+
85
+ 回报实际改动与对象 URL(如有)、回读或验证结果、授权范围内已执行的副作用,以及剩余阻塞。区分本地静态检查、远程读取、CI 验证和实际发布,不把其中一种当作另一种的完成证据。
@@ -0,0 +1,72 @@
1
+ ---
2
+ name: tsgw-mk-docs
3
+ license: MIT
4
+ description: 用于按设计文档治理规范创建、迁移、验证和维护项目设计文档骨架,明确需求、设计、执行计划、术语与状态证据的分工,并处理文档审阅反馈、修订、复审及获授权后的执行验收记录。
5
+ ---
6
+
7
+ # 设计文档制作与进度管理
8
+
9
+ ## 使用边界
10
+
11
+ - 本技能是独立的中文文档治理规则与静态参考资源,不包含运行时代码,不依赖审阅插件。
12
+ - 仅复制、收纳、打包、审计或维护本技能时,不启动项目文档规划、不创建项目设计文档。
13
+ - 资源路径相对于当前文件;参考资料中的链接相对于各自文件。来源与完整资源清单见 [来源与适配说明](SOURCE.md)。
14
+ - 不假定任何宿主专属命令、固定工具名或已安装插件可用;需要工具时以当前会话现场核验为准,不擅自安装、启用或修改配置。
15
+
16
+ ## 适用范围
17
+
18
+ - 用户需要创建、迁移、验证或维护项目设计文档骨架。
19
+ - 目标是把设计信息收敛到 `000.*`、`A00/B00/C00` 主文档及其后续工作包中。
20
+ - 若项目 `AGENTS.md` 与本技能冲突,以项目 `AGENTS.md` 的项目事实、路径、例外、验证入口为准;若冲突涉及通用规范,先暴露冲突并澄清。
21
+
22
+ ## 标准骨架
23
+
24
+ - `000.名词解释.md`
25
+ - `000.TODO.md`
26
+ - `A00.需求分析.md`
27
+ - `B00.规划设计.md`
28
+ - `C00.执行计划/详细设计.md`
29
+
30
+ ## 资源导航
31
+
32
+ - [跨文档边界、迁移归位、轻量追踪关系](references/design-doc-boundaries.md)
33
+ - [000.名词解释.md 编写与使用说明](references/000-terminology.md)
34
+ - [000.TODO.md 编写与使用说明](references/000-todo.md)
35
+ - [000.TODO.md 模板](assets/000-todo.template.md)
36
+ - A 系列:[总览](references/a-series/overview.md)、[模块裁剪](references/a-series/modules.md)、[复核清单](references/a-series/checklist.md)
37
+ - B 系列:[总览](references/b-series/overview.md)、[模块裁剪](references/b-series/modules.md)、[复核清单](references/b-series/checklist.md)
38
+ - C 系列:[总览](references/c-series/overview.md)、[模块裁剪](references/c-series/modules.md)、[复核清单](references/c-series/checklist.md)
39
+
40
+ ## 推荐阅读顺序
41
+
42
+ 1. 先读项目适用的 `AGENTS.md` 等规则和现有文档路径;项目指定的正式文档体系优先,不强制另建标准骨架。
43
+ 2. 拿不准内容归属时,先读 [跨文档职责边界](references/design-doc-boundaries.md)。
44
+ 3. 再按目标文档进入对应 `overview.md`、`modules.md`、`checklist.md`。
45
+ 4. 状态与证据指针统一回写 `000.TODO.md` 或项目指定的状态记录。
46
+
47
+ ## 迁移授权门槛
48
+
49
+ - 先完成只读盘点,按术语、需求、设计、执行、状态分类,完整列出每个源文件及其段落或章节、目标文件及目标位置、保留或调整方式。
50
+ - 必须在任何迁移写入前展示全部清单,包括新增、覆盖、改写、删除、重命名和引用修正,不以样例或部分清单代替。
51
+ - 等待用户针对完整清单明确授权后才写入;清单有实质变化时先补充说明并重新确认,未授权时仅提供分析。
52
+ - 用户授权本地技能收纳或打包,不等于授权迁移项目文档;本技能也不授予超出用户任务范围的写入权限。
53
+
54
+ ## 正式文档审阅与授权边界
55
+
56
+ - 项目 `AGENTS.md` 的目录与例外规则始终优先,不要求项目引入 `000/A00/B00/C00` 骨架。
57
+ - 优先审阅已有正式文档:需求审阅对应 A 层,设计审阅对应 B 层,执行审批对应 C 层;采用其他目录体系的项目使用其职责对应的正式文档。
58
+ - 优先复用正式执行计划,在其中提供本次范围的实施清单与验证入口,不另建 `PLAN.md` 或 `plans/` 作为第二份权威计划;审阅要求与正式文档结构冲突时,先说明差异并确认适配方式。
59
+ - 审阅前确认文档职责、版本、操作范围和验收口径,检查需求、设计与执行计划是否一致。
60
+ - 收到审阅反馈后,按需求、设计、实现或状态职责回写对应正式文档;涉及范围或授权变化时先确认。审阅历史和归档副本不能替代正式来源。
61
+ - 修订后检查跨文档一致性,说明变化并按需复审,不把旧版批准沿用到实质变更后的文档。
62
+ - 普通批注不等于执行审批;需要执行时取得明确授权,并在受审文档中列明修改对象、范围、验证标准及必要的回滚边界。
63
+ - 批准只授权受审版本明确列出的操作,不自动包含发布、部署、删除、凭据或权限调整等未列出或要求单独确认的动作。被退回或发生实质范围变更时,先修订并重新确认,不执行旧版计划。
64
+ - 获授权后依据受审版本推进,继续维护正式计划、状态记录和验证证据;新增需求或架构变化先回到对应文档补齐决策,执行进度与验收证据回写 `000.TODO.md` 或项目指定的状态记录,只有验证通过才标记完成。
65
+ - 始终遵守只读规划、项目安全规则与授权边界,不以工具可调用作为扩大授权的依据;遇到冲突时暂停受影响的操作,说明冲突并确认处理方式。
66
+
67
+ ## 执行要求
68
+
69
+ - 文档写作应使用符合中文正规文献或软件工程专业规范的书面用语。
70
+ - 避免口语化表达、内部黑话、语义含混的缩略说法,以及无必要的中英混杂表述。
71
+ - 同一概念在全套文档中保持术语和称谓一致。
72
+ - 必须使用外文术语时,给出规范中文名,或明确约定主叫法。
@@ -0,0 +1,47 @@
1
+ # 来源与适配说明
2
+
3
+ ## 来源与授权
4
+
5
+ - 来源:用户提供并授权本地收纳的 Pi 较新版本个人技能 `mk-docs/`,以本次读取的本地快照为准;不声称来自特定上游发布号。
6
+ - 初次收纳时完整读取来源的 `SKILL.md`、`references/` 和 `assets/` 后复制适配,未使用旧宿主版本替代。后续按用户授权移除项目版及用户级来源正文中的审阅插件联动提示,保留独立文档治理约束。
7
+ - 技能名称改为 `tsgw-mk-docs`,frontmatter 许可证标识为 `MIT`,按用户授权收纳;不将本地授权表述为未经核实的上游许可证声明。
8
+ - 为保持可移植性,不记录本机绝对路径。下列路径均相对于本文件,与来源资源的相对位置一一对应。
9
+
10
+ ## 完整资源清单
11
+
12
+ 来源共 14 个文件,全部保留;本文件为新增的来源与边界说明。
13
+
14
+ | 文件 | 处理 |
15
+ | --- | --- |
16
+ | [SKILL.md](SKILL.md) | 保留独立治理正文,修改名称、许可证及资源链接,补充使用与迁移授权边界;已移除审阅插件联动提示与专项流程 |
17
+ | [references/design-doc-boundaries.md](references/design-doc-boundaries.md) | 原样保留 |
18
+ | [references/000-terminology.md](references/000-terminology.md) | 原样保留 |
19
+ | [references/000-todo.md](references/000-todo.md) | 修正资源相对链接,澄清项目规则和技能包行数边界 |
20
+ | [references/a-series/overview.md](references/a-series/overview.md) | 将同目录资源导航改为可点击相对链接 |
21
+ | [references/a-series/modules.md](references/a-series/modules.md) | 原样保留 |
22
+ | [references/a-series/checklist.md](references/a-series/checklist.md) | 原样保留 |
23
+ | [references/b-series/overview.md](references/b-series/overview.md) | 将同目录资源导航改为可点击相对链接 |
24
+ | [references/b-series/modules.md](references/b-series/modules.md) | 原样保留 |
25
+ | [references/b-series/checklist.md](references/b-series/checklist.md) | 原样保留 |
26
+ | [references/c-series/overview.md](references/c-series/overview.md) | 将同目录资源导航改为可点击相对链接 |
27
+ | [references/c-series/modules.md](references/c-series/modules.md) | 原样保留 |
28
+ | [references/c-series/checklist.md](references/c-series/checklist.md) | 原样保留 |
29
+ | [assets/000-todo.template.md](assets/000-todo.template.md) | 原样保留 |
30
+
31
+ ## 治理与适配边界
32
+
33
+ - 保留 A 层需求与完成标准、B 层设计与边界、C 层实现与验证、000 层术语及状态证据的分工,包括小项目最小模式、轻量追踪和回退规则。
34
+ - 保留迁移前完整展示源文件与章节到目标文件的清单、明确授权后才写入的要求;删除或改写源文件同样纳入确认。
35
+ - 项目规则、正式文档路径及例外优先;通用规范冲突先说明并澄清,不为了套用骨架另建权威文档。
36
+ - 已移除审阅插件的联动描述、模式核验、开启提醒、调用入口和专项协作流程;不再要求用户进入插件审阅流程。
37
+ - 保留通用约束:优先复用正式执行计划,不另建第二份权威计划;审阅反馈按职责回写,修订后检查一致性并按需复审。
38
+ - 不依赖固定工具名、特定宿主入口或插件安装状态推断能力;需要工具时现场核验,不擅自安装、启用或修改配置。
39
+ - 审阅批注不等于执行批准;批准仅覆盖受审版本及明确操作,不扩张至发布、部署、删除、凭据或权限调整;实质变更须重新确认。
40
+ - 本包仅包含静态 Markdown 规则、参考资料和模板,不依赖审阅插件;收纳和维护本包本身不启动文档规划或审阅流程。本次清理仅修改技能提示词,不卸载插件或修改其安装与配置。
41
+
42
+ ## 完整性检查口径
43
+
44
+ - 对照来源相对路径检查 14 个文件均存在;标为原样保留的文件应逐字节一致。
45
+ - 检查全部 Markdown 内部相对链接可解析到包内文件;正文中的 A/B/C/000 名称为目标文档角色示例,不是假定项目已存在对应文件。
46
+ - 来源最长文件为 146 行,无需拆分;本包每个文件均须不超过 500 行,后续超限时按主题拆分并同步修正链接。
47
+ - 检查无本机绝对路径、无特定其他宿主的入口假定、无运行时脚本或自动安装命令。
@@ -0,0 +1,21 @@
1
+ # 000.TODO 项目状态与实施治理待办
2
+
3
+ ## 树形 TODO
4
+
5
+ <!-- 新项目默认从第 3 级 `AB-01` 开始;需要更高层聚合时再向上补 `A-1` / `A-01`。 -->
6
+
7
+ - [ ] 项目目标
8
+ - [ ] `AB-01` 能力域 / 工作组
9
+ - [ ] `ABC-01` 工作包名称
10
+ - [ ] `ABC-00001` 确认 A/B/C 文档依据已存在且足以支撑本工作包。
11
+ - 证据: `A00`/`B00`/`C00` 或对应子文档路径与章节
12
+ - [ ] `ABC-00002` 执行任务描述。
13
+ - 前置依赖: ABC-00001
14
+ - 验收证据: ...
15
+ - 阻塞: 仅在影响执行或验收时填写
16
+ - [ ] `ABD-01` 第二工作包名称
17
+ - [ ] `ABD-00001` 确认 A/B/C 文档依据已存在且足以支撑本工作包。
18
+ - 证据: `A00`/`B00`/`C00` 或对应子文档路径与章节
19
+ - [ ] `ABD-00002` 执行任务描述。
20
+ - 前置依赖: ABD-00001
21
+ - 验收证据: ...