Skip to content

feat: add AGENTS.md#358

Merged
YufJi merged 3 commits into
testfrom
feature/spec-kit
May 8, 2026
Merged

feat: add AGENTS.md#358
YufJi merged 3 commits into
testfrom
feature/spec-kit

Conversation

@YufJi
Copy link
Copy Markdown
Collaborator

@YufJi YufJi commented Apr 29, 2026

Summary by CodeRabbit

  • 文档
    • 新增项目架构和开发指南文档,详细说明目录结构、环境依赖版本、构建部署流程、CI/CD 工作流、Git 提交规范和代码实践标准

@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai Bot commented Apr 29, 2026

走查

新增 AGENTS.md 文档文件,详细记录低代码应用模板的 monorepo 架构、环境要求、包依赖关系、构建流程、CI/CD 工作流、发布流程和开发规范等核心配置信息。

改动

分组/文件 摘要
文档新增
AGENTS.md
新增架构文档,包含 monorepo 布局、环境/工具版本要求、包依赖映射表、构建测试部署命令、设计原则、发布流程、CI/CD 工作流、Git 提交规范和操作注意事项。

预期代码审查工作量

🎯 1 (平凡) | ⏱️ ~3 分钟

诗歌

📚 一份文档悄然生,
架构蓝图展眼前,
Monorepo 层次分明,
构建流程心中清,
兔子为你记下笔,
助你扬帆去远航~ 🐰✨

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed PR标题准确描述了主要变化:添加新的AGENTS.md文档文件,与变更集完全相关且简洁清晰。
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch feature/spec-kit

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share
Review rate limit: 0/1 reviews remaining, refill in 60 minutes.

Comment @coderabbitai help to get the list of available commands and usage tips.

@YufJi YufJi changed the title Feature/spec kit feat: add AGENTS.md Apr 29, 2026
Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 2

🧹 Nitpick comments (2)
AGENTS.md (2)

89-96: 为构建流程代码围栏补全语言标识(MD040)

第 89 行的构建流程围栏使用了 ``` 但未指定语言;建议同样改为 text,保持 lint 干净。

✅ 建议改法
-LCAP_RELEASE=1 pnpm build
+```text
+LCAP_RELEASE=1 pnpm build
   → turbo run build (按依赖顺序)
     → basic: Rollup 打包 → dist/ + typings/
     → vue2: Webpack 构建 → dist/
     → vue3: Rspack 构建 → dist/
     → react: 自定义构建 → dist/
-```
+```
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@AGENTS.md` around lines 89 - 96, Add a language identifier to the fenced code
block that contains the build steps (the triple backticks surrounding the lines
starting with "LCAP_RELEASE=1 pnpm build ... → react: 自定义构建 → dist/"); change
the opening ``` to ```text so the block is explicitly marked as "text" and
satisfies MD040 linting while leaving the block contents unchanged.

7-19: 为代码围栏补全语言标识(MD040)

第 7 行的树状结构代码围栏使用了 ``` 但未指定语言;按 markdownlint-cli2 要求应补全语言标识(例如 text),避免 lint 失败。

✅ 建议改法
-```
+```text
 lcap-template/
 ├── packages/
 │   ├── basic/          # 通用纯函数库,不依赖框架
 │   ├── vue2/           # Vue 2 框架应用模板
 │   ├── vue3/           # Vue 3 框架应用模板
 │   └── react/          # React 框架应用模板
 ├── mini-folder/
 │   ├── taro/           # Taro 小程序应用模板
 │   └── build/          # 小程序构建配置
 ├── scripts/            # 根目录脚本
 └── docs/               # 文档输出目录
-```
+```
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@AGENTS.md` around lines 7 - 19, The fenced code block in AGENTS.md (the tree
diagram between the triple backticks) lacks a language identifier which triggers
markdownlint MD040; update the opening fence from ``` to include a neutral
language label such as ```text so the block becomes ```text, leaving the block
contents unchanged; ensure only the opening fence is modified and the closing
``` remains as-is.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@AGENTS.md`:
- Around line 54-55: Replace the literal --username and --password placeholders
in the pnpm run deploy example with references to environment variables or CI
secrets to avoid showing credentials in docs; specifically update the example
invocation that contains the flags --username and --password to instead use
environment-backed values (e.g., use "$DEPLOY_USER" and "$DEPLOY_PASS" or
instruct readers to export DEPLOY_USER/DEPLOY_PASS or use CI secret injection)
or provide an alternative auth method, and update the surrounding text to
instruct using environment variables/CI secrets rather than inline plaintext
credentials.
- Around line 24-26: Update the pnpm minimum version in AGENTS.md to match
package.json's packageManager value by changing the pnpm requirement from ">= 8"
to ">= 9.10.0" (or explicitly mention "pnpm@9.10.0+") so the document aligns
with the packageManager field; ensure the textual entry referencing pnpm in
AGENTS.md and any adjacent version notes reflect the same "pnpm@9.10.0"
baseline.

---

Nitpick comments:
In `@AGENTS.md`:
- Around line 89-96: Add a language identifier to the fenced code block that
contains the build steps (the triple backticks surrounding the lines starting
with "LCAP_RELEASE=1 pnpm build ... → react: 自定义构建 → dist/"); change the opening
``` to ```text so the block is explicitly marked as "text" and satisfies MD040
linting while leaving the block contents unchanged.
- Around line 7-19: The fenced code block in AGENTS.md (the tree diagram between
the triple backticks) lacks a language identifier which triggers markdownlint
MD040; update the opening fence from ``` to include a neutral language label
such as ```text so the block becomes ```text, leaving the block contents
unchanged; ensure only the opening fence is modified and the closing ``` remains
as-is.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro

Run ID: 41bf6ebf-567c-4f32-a3a0-d72ff286109b

📥 Commits

Reviewing files that changed from the base of the PR and between c383f01 and 53f23f4.

📒 Files selected for processing (1)
  • AGENTS.md

Comment thread AGENTS.md
Comment on lines +24 to +26
- **Node.js**: >= 18
- **pnpm**: >= 8 (packageManager: pnpm@9.10.0)
- **Turbo**: 构建编排
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

🧩 Analysis chain

🏁 Script executed:

git ls-files | grep -i "agent"

Repository: netease-lcap/lcap-template

Length of output: 80


🏁 Script executed:

cat AGENTS.md

Repository: netease-lcap/lcap-template

Length of output: 2756


🏁 Script executed:

fd "package" --type f | head -20

Repository: netease-lcap/lcap-template

Length of output: 402


🏁 Script executed:

cat package.json | head -30

Repository: netease-lcap/lcap-template

Length of output: 912


🏁 Script executed:

rg "packageManager|pnpm" package.json

Repository: netease-lcap/lcap-template

Length of output: 234


🏁 Script executed:

rg "pnpm" --type json packages/ | grep -i version

Repository: netease-lcap/lcap-template

Length of output: 52


统一 pnpm 最低版本要求至 9.10.0+

package.json 中 packageManager 字段指定的版本为 pnpm@9.10.0,但 AGENTS.md 第 25 行写的是 >= 8,两者不一致。建议更新文档以避免混淆开发者。

建议改法
-- **pnpm**: >= 8 (packageManager: pnpm@9.10.0)
+- **pnpm**: >= 9.10.0 (packageManager: pnpm@9.10.0)
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@AGENTS.md` around lines 24 - 26, Update the pnpm minimum version in AGENTS.md
to match package.json's packageManager value by changing the pnpm requirement
from ">= 8" to ">= 9.10.0" (or explicitly mention "pnpm@9.10.0+") so the
document aligns with the packageManager field; ensure the textual entry
referencing pnpm in AGENTS.md and any adjacent version notes reflect the same
"pnpm@9.10.0" baseline.

Comment thread AGENTS.md
Comment on lines +54 to +55
pnpm run deploy --platform a --username b --password c
```
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟠 Major

避免在文档示例中直接出现账号/密码参数(安全最佳实践)

第 54 行的部署示例将 --username / --password 以明文参数形式写在命令行里。即使是占位符,实际使用时也很容易被复制粘贴成真实凭据,造成泄漏风险。建议改为:使用环境变量(或 CI secret)并在文档中示例 --username "$DEPLOY_USER" / --password "$DEPLOY_PASS",或提供不带明文密码的认证方式。

✅ 建议改法示例
-pnpm run deploy --platform a --username b --password c
+pnpm run deploy --platform a --username "$DEPLOY_USER" --password "$DEPLOY_PASS"
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
pnpm run deploy --platform a --username b --password c
```
pnpm run deploy --platform a --username "$DEPLOY_USER" --password "$DEPLOY_PASS"
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@AGENTS.md` around lines 54 - 55, Replace the literal --username and
--password placeholders in the pnpm run deploy example with references to
environment variables or CI secrets to avoid showing credentials in docs;
specifically update the example invocation that contains the flags --username
and --password to instead use environment-backed values (e.g., use
"$DEPLOY_USER" and "$DEPLOY_PASS" or instruct readers to export
DEPLOY_USER/DEPLOY_PASS or use CI secret injection) or provide an alternative
auth method, and update the surrounding text to instruct using environment
variables/CI secrets rather than inline plaintext credentials.

@YufJi YufJi merged commit dd31410 into test May 8, 2026
2 checks passed
@YufJi YufJi deleted the feature/spec-kit branch May 8, 2026 06:48
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant